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Preface 


This manual provides reference data for executing the Sentry assembly language 
under the MASTR operating system (Rel. 2.1). The manual describes the conventions, 
system tables and system as used by the assembler. 


Use of this manual assumes a previous understanding of the Sentry assembly lan- 
guage and its application to the Sentry test systems. Users who intend to imple- 
ment assembler programs to augment FACTOR language capabilities must also 
have a detailed knowledge of the Sentry operating system characteristics. 


The role of this manual is to provide the Sentry system programmer with the 
details necessary to implement user-written assembly language overlays under the 
MASTR operating system. Appendix C provides supplementary information on the 
conversion of TOPSY/DOPSY user overlays to MASTR. 


The following manuals are suggested for reference and supplemental reading: 


Description Publication Number 
FST-2 Computer Manual 97000002 
Sentry VII Users Manual 97000013 
MASTR Command Language Reference Manual 57518701 
MASTR FACTOR Manual 57518700 
Caution 


The description of the MASTR system in this manual 

is provided for reference purposes only. Any alteration 
of the operating system may cause disastrous effects, 
including damage or destruction of the tester hardware. 
The direct use of system tables is inadvisable because 
the table may be changed without notice. Use of any 
routines noted as reserved for system use only may re- 
sult in undefined operations. Any modification of the 
system software is performed at the sole risk of the 
user. Fairchild Test Systems Group will provide no 
support for modified software systems. Fairchild Test 
Systems Group reserves all rights to the software de- 
seribed in this manual. Contents and descriptions are 
subject to change without notice. 
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Introduction 


1.1 OVERVIEW 


The information within this manual describes the interface between user written 
overlays and the MASTR operating system. The information pertains to the 
interface only; details of assembly language commands and their use are defined 
in the FST-1 Assembler Manual (publication number 67094951) and the FST-2 
Computer Manual (publication number 57000002). 


An overlay is an assembly language program that is loaded into memory to 
perform a particular function. This manual describes the assembly language 
under MASTR as a reference for user written overlays. It contains detailed 
descriptions of the conventions, system tables, and system subroutines available 
with MASTR software. 


Two types of user-written assembly language programs or files may be executed 
under MASTR. The first type of assembly language program is one which is called 
by a FACTOR test program. These are called Assembly Language Linkage files 
or ALLINK files. 


The second type of assembly language program is one which is called by an opera- 
tor command while no test station is active. These files are called user overlays. 
They are not to be confused with the system overlays, DATALOG for example, 
which are called into memory as the system demands. To be executed, system 
overlays must be resident on the disk or in memory. 

1.2 MANUAL CONTENTS 

This manual is divided into six sections, each one addressing a different facet 

of MASTR software. 


1.2.1 Introduction 


Section 1 is a general introduction to MASTR organization and gives a brief 
summary of the reference material that will be encountered. 


I-1 


1.2.2 System Global Data 


Section 2 includes a listing of system global data. The system global data tables 
are divided into five categories: 


Global Constants Tables. These tables contain the constants frequently used 
by the system and overlays. They are located at an absolute memory loeation 
in order to be referenced via an EQU to the address. 


System Variables Tables. This table contain the system configuration. Variables 
are referenced via an EQU. 


Global Variables Tables. System related items which are global in nature and 
not unique for each station. They are referenced directly via an EQU. 


Tester Variables Tables. Contains data unique to each of up to four test heads. 
They are referenced via index register 2. 


Current Station Variables Tables. Contains data unique to the station which | 
is currently on line. They are referenced via index register 1. 


Each listing contains the following information for the data words: 


Location in memory 

Octal representation of the data 
Symbolic label 

Assembler opcode 

Operand 

Comment field 


The listings are followed by individual descriptions of the 24-bit data words 
eontained in the table. Bit position information is provided where applicable. 


1.2.3 System Subroutines 


Section 3 provides information about the system subroutines, beginning with a 
listing of the system subroutine transfer vector. It describes those system proce- 
dures that are available to users by means of the CALL directive. Each 
subroutine is described along with the calling sequence needed to activate it 
under MASTR. 


» Pe? 


1.2.4 Input/Output Control System ($IOCS) 


Section 4 describes the Input/Output Control System ($IOCS). MASTR software 
requires that all I/O functions must be accomplished through $IOCS to preserve 
foreground/back-ground configuration. This section provides the programmer 
with information concerning principles of operation, handling of devices, $IOCS 
functions, and the general calling sequence format. The I/O Assignment Table 
(IOATAB) is provided along with a detailed explanation of each data word. I/O 
operations available with MASTR are individually discussed, and the calling se- 
quence for each is provided. 


1.2.5 MASTR System Files 


Section 5 contains information about the manner in which MASTR maintains sys- 
tem files. Physical and logical formats are described for disk, magnetic tape, 
Integrator and memory file storage. The system memory map (figure 4-12) 
shows the MASTR file organization in memory. 


1.2.6 ALLINK Programs 


Section 6 describes linking of Assembly Language overlays (ALLINK programs) 
under MASTR. It shows MASTR format for ALLINK program headers and the 
loading and calling procedures from foreground and background. Seheduling back- 
ground tasks from foreground is explained. A sample ALLINK program is pro- 
vided. Figure 6-1 gives a working example of the MASTR ALLINK file. 


System Global Data 


This section describes system globals and their use in assembly language 
programs. 


2.1 GENERAL DESCRIPTION AND USAGE 


There are three types of globals available: constants, variables, and subroutine or 
label addresses. All globals are located in the base page at absolute addresses. 
By defining the data name and boume to the global address, the user may access 
any global data. 


2.1.1 Global Constant Usage 

BITFLD at 102B Binary constants with one bit set 

NBTFLD at 132B Binary constants with one bit not set 

RTMSK at 162B Binary constants with more than one bit set from 
bit 0 

LFMSK at 211B Binary constants with more en one bit set from 
bit 23 

OCTFLD at 237B Octal numbers 

DECFLD at 237B Decimal numbers 

DBFLD at 404B Binary constants with two or more bits set 


The complete list of available constants is provided in figure 2-1. 


Examples of usage: 


BITFLD EQU 102B_ 

RTMSK EQU 162B 

B10 EQU BITFLD+10 2000B 

B23 EQU BITFLD+23 40000000B 

MINUS1 EQU RTMSK+22 CTTTTT TTB 
LDA B10 


AND MINUSI 


2.1.2 Global Variable Usage 

GLOVAR at 420B 

Variables listed under GLOVAR are used to transfer data between different 
programs. Each data item has a particular meaning and must be used according 
to the individual definition. Detailed descriptions of variables are provided in 
figure 2-3. 


Example of usage: 


GLOVAR EQU 420B 


REVN EQU GLOVAR+23 
LDA REVN 
2.1.3 System Global Variable Usage 


SYSVAR at 64B 

Variables listed under SYSVAR are used by MASTR to define system initialization 
conditions. These conditions in general are: default device for file loading and 
dumping; miscellaneous configuration flags; line printer type; miscellaneous disk 
addressing information for directory, file area, and working storage; and starting 
address of monitor after bootstrap. 

Example of usage: 


SYSVAR EQU 64B 
SELP EQU- SYSVAR+2 


LDA SELP 


2.1.4 Global Subroutine Usage 
SY XVEC at 640B 
The starting address of the transfer vectors is located at 640B. There are 63 


global subroutines. Detailed descriptions of global subroutines are provided in 
section 3. The transfer vector is shown in figure 3-1. 
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The transfer vectors follow the SYXVEC address. 


Example of usage: 


SYXVEC EQU 


FFIX EQU 

$1OCS ~EQU 
BSM* 
BSM* 


640B 
SY XVEC+57 
SYXVEC+5 


FFIX 
$1OCS 


2.2 


GLOBAL CONSTANTS 


A listing of global constants appears in figure 2-1. 


00101 


00102 
00103 
00104 
00105 
09106 
00107 
00110 
NO111 
00112 
00113 
00114 
N0115 
00116 
00117 
00120 
00121 
00122 
019123 
00124 
00125 
00126 
00127 
00130 
00131 


00132 
00133 
00134 
00135 
00136 
00137 
00140 
00141 
00142 
00143 
00144 
00145 
00146 
00147 
00150 
00151 
00152 
00153 
00154 
00155 
00156 
00157 
00160 
00161 


00000001 
009000102 
90000001 
00000002 
00000004 
00000010 
00000020 
00000040 
00000100 
00000200 
00000400 
00001000 
00002000 
00004000 
00010000 
00020000 
00040000 
00100000 
00200000 
00400000 
01000000 
02000000 
04000000 
10000000 
20000000 
40000000 


00000132 
77777776 
77777775 
77777773 
77777767 
77777757 
77777737 
77777677 
77777577 
77777377 
77776777 
77775777 
77773777 


T7767777 © 


T77T57777 
T7TT37777 
77677777 
77577777 
T7377777 
T6777777 
75777777 
73777777 
67777777 
S7777777 
37777777 


Figure 2-1 


PAGE 


BIT FIELD DEFINITIONS 


RX IMPLIES RIT X IS SET 


NBX IMPLIES NOT BIT X IS SET 
BIT X THRU Y ARE SET 


SINGLE BIT FIELDS 


x 
* 
x 
* BXSY IMPLIES 
* 
* 
* 


B15 
B16 
B17 
B18 
819 
B20 
B21 
Bee 
B23 
* 


DATA 
EQU 

DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


100000B 
2000008 
4000008 
10000008 
20000008 
40000008 
1000000086 
200000008 
400000008 


* NOT BIT=TABLE (INVERSE 


* 
NRATFLP 
NBO 
NH 1 
NB2 
NB3 
NB4 
NB5 
NB6 
Ni7 
NB& 
NBY 
NB10 
NB11 
NB12 
NB13 
NB14 
NB15 
NB16 
NB17 
N618 
NB19 
NB20 
NB21 
NR22 
NB23 


EQU 

DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DNATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
NATA 
DATA 
DATA 


* 
777777768 
777777758 
777777738 
777777678 
777777578 
777777378 
777776778 
777775778 
777773778 
777767778 
777757778 
777737778 
777677778 
777577778 
777377778 
T7T677777B 
775777778 
773777778 
767777778 
757777778 
737777778 
677777778 
S7777777B 
377777778 


Global Constants Listing 


FOR PMU CONVERGENCE TABLE 


OF BIT) 
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10162 
00163 
00164 
00165 
00166 
00167 
00170 
00171 
00172 
00173 
00174 
00175 
00176 
00177 
00200 
00201 
00202 
00203 
00204 
00205 
00206 
00207 
00210 


00211 
00212 
00213 
00214 
90215 
09216 
00217 
00220 
00221 
00222 
0023 
00224 
00225 
00226 
00227 
00230 
00231 
00232 
00233 
00234 
00235 
00236 


09000162 


00000003 
00000007 
00000017 
00000037 
00000077 
00000177 
00000377 
00000777 
00001777 
00003777 
00007777 
00017777 
00037777 
00077777 
00177777 
00377777 
00777777 
01777777 
03777777 
07777777 
17777777 
37777777 
77777777 


00000211 


77777776 
77777774 
77777770 
77777760 
T77T77740 
77777700 
77777600 
77777400 
77777000 
77776000 
77774000 
77770000 
77760000 
77740000 
77700090 
77600000 
77400000 
77000000 
76000000 
74000000 
70000000 
60000000 


Figure 2-1 
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PAGE 


* ASSORTED MASKS 


* 
RTMSK 


B23h21 
B23822 


Global Constants Listings (Continued) 


EQU 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


* 


3B 

78 

176 

378 

778 

177B 

377B 

777B 
17776 
37776 
77778 
177778 
37777B 
777778 
17777768 
3777778 
7777778 
17777778 
37777778 
77777778 
177777778 
377777778 
777777778 


* 


777777768 
777777748 
777777708 
777777608 
777777408 
777777008 
777776008 
777774008 
777770008 
777760008 
777740008 
777700008 


777600008 | 


777400008 
777000008 
77600000B 
774000008 
770000008 
760000008 
740000008 
7900000008 
600000008 


= 
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00237 
00240 
00241 
00242 
00243 
00244 
00245 
00246 
00247 
00250 
00251 
00252 
00253 
00254 
00255 
00256 
00257 
00260 
00261 
00262 
00263 
00264 
00265 
00266 
00267 
00270 
00271 
00272 
00273 
00274 
00275 
00276 
00277 
00300 
00301 
00302 
00303 
00304 
00305 
00306 
00307 
00310 
00311 
00312 
00313 
00314 
00315 
00316 
00317 
00320 
00321 
00322 
00323 
00324 
00325 
00326 


00000237 
00000237 


00000000 
90000001 
00000002 
00000003 
00000004 
00000005 
00000006 
00000007 
00000010 
00000011 
00000012 
00000013 
90000014 
09000015 
00000016 
00000017 
00000020 
00000021 
00000022 
00000023 
00000024 
00000025 
00000026 
00000027 
00000030 
00000031 
00000032 
00000033 
00000034 
00000035 
00000036 
00000037 
00000040 
00000041 
00000042 
00900043 
00000044 
00000045 
00000046 
00000047 
00000050 
00000051 
00000052 
00000053 
00000054 
10000055 
00000056 
00000057 
00000060 
00000061 
00000062 
00000063 
00000064 
00000065 
00000066 
00000067 


Figure 2-1 


* 


* DECIMAL/OCTAL NUMBER 


* 
DECFLD 
OCTFLD 


PAGE 


EQU 
EQU 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
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DECIMAL FIELD 
OCTAL FIELD 
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+52 
+53 
#54 
+55 
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00327 
00330 
00331 
00332 
00333 
00334 
00335 
00336 
00337 
00340 
09341 
00342 
00343 
00344 
00345 
00346 
00347 
00350 
00351 
00352 
00353 
00354 
00355 
00356 
00357 
00360 
00361 
00362 
00363 
00364 
00365 
00366 
00367 
00370 
00371 
00372 
00373 
00374 
00375 
00376 
00377 
00400 
00401 
00402 
00403 


00404 
00405 
00406 
00407 
00410 


00411 


00000070 
09000071 
00000072 
00000073 
00000074 
00000075 
00000076 
00000077 
00000100 
00000101 
00000102 
00000103 
00000104 
00000105 
00000106 
00000107 
00000110 
00000111 
00000112 
00000113 
00000114 
00000115 
00000116 
00000117 
00000120 
00000121 
00000122 
00000123 
00000124 
00000125 
00000126 
00000127 
00000130 
00000131 
00000132 
00000133 
00000134 
00000135 


00000136 


00000137 
00000140 
00000141 
90000142 
00000143 
00000144 


00000113 
00000210 
00000211 
00000212 


00000404 
00006000 
00014000 
37000000 
00000360 
00000300 
00000255 
00001700 


Figure 2-1 


D60 


D62 
D63 
D64 
Dé5 


D67 


D73 
D74 


N80 


DBS 


D92 


” 
x 
* DOUBLE 
* 

DBFLD 
B11$10 
R1i2811 
B22818 
B7$4 
B7$6 
B3$1 
D960 


DATA 56 

DATA 57 

DATA 58 

DATA 59 

DATA 60 

DATA 61 

DATA 62 

DATA 63 

DATA 64 

DATA 65 

DATA 66 

DATA 67 

DATA 68 

DATA 69 

DATA 70 

DATA 71 

DATA 72 

DATA 73 

DATA 74 

DATA 75 

DATA 76 

DATA 77 

DNATA 78 

DATA 79 

DATA 80 

DATA Bi 

DATA 62 

DATA 83 

DATA 84 

DATA 85 

DATA 86 

DATA 87 

DATA 88 

DATA 89 

DATA 90 

DATA 91 

DATA 92 

DATA 93 

DATA 94 

DATA 95 

DATA 96 

DATA 97 

DATA 98 

DATA 99 

DATA 100 

EQU  BITFLD+9 
EGU RTMSK+22 
EQU LFMSK+0 
EQU LFMSK+1 
PAGE 

BIT FIELDS 

EQU * 

DATA 000060008 
DATA 000140008 
DATA 370000008 
DATA 00000360B 
DATA 000003008 
EQU D14 

DATA 960 


+56 
+57 
+58 
+59 
+60 
+61 
+62 
+63 
+64 
+65 
+66 
+67 
+68 
+69 
+70 
+71 
+72 
+73 
+74 
+75 
+76 
+77 
+78 
+79 
+80 
+81 
+82 
+83 
+84 
+85 
+86 
+87 
+88 
+89 
+90 
+91 
+92 
+93 
+94 
+95 
+96 
+97 
+98 
#99 
+10 


2-7 


0 


SEWN Oo Z 


Global Constants Listings (Continued) 


2.3 


SYSTEM GLOBAL VARIABLES 


A listing of system variables appears in figure 2-2. 


PAGE 
00000064 ORG 646 
* 
* GLOBAL VARIABLE FOR USE BY THE SYSTEM 
x 
00000064 SYSVAR EQU * N 
00064 00000210 ODFDV DATA 2108 0 DEFAULT DEVICE FOR FILE LOAD/DUMP 
00065 00000000 MILINIT DATA 0 1 SYSTEM INITIALIZED FLAG 
00066 00000002 SFLP DATA 2 LP TYPE, DEFAULT=PRINTRONIX 
00067 00000000 MiWSWC DATA Q 3 # OF WORD IN WS 
90070 00000000 MIWSSC DATA 0 4 # OF SECTORS IN WS 
00071 00000000 MiWSDA DATA 0 5 START SECTOR OF WS 
00072 00000000 MIFDDA DATA 0 6 START SECTOR OF DIRECTORY 
00073 00000000 M{FDA DATA 0 7 START SECTOR OF FILE AREA 
00074 00000000 DATA 0 8 SPARE 
00075 00001753 DATA SYSINT 9 ENTRY POINT 
00076 00000000 DATA 0 10 SPARE 
* 
00000100 ORG 1008 
00100 01002107 BRU MPRO RESTART FROM 100B 
Figure 2-2 System Global Variables Listing 
2.3.1 DFDV (SYSVAR + 0) 


Contains the default device code for file loading and dumping. For a disk-based 
system it is set to disk by $MASTR. Otherwise, it is set to magnetic tape unit 1. 


23 8 4 0 


Output Input 


output 5 disk system 
8 memory system 


input 5 disk system 
8 memory system 
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2.3.2 MINIT (SYSVAR + 1) 
Contains the following system configuration flags: 
Bit Function 
23 0 first execution | 
1 it has been executed before (set by system initializer $MASTR 
and never cleared until it is recreated) 


19 Flag to subroutine PUTA 


0 address output in decimal 
1. address output in octal 


18 0 I1V/ImV 
1 2V/2mvV 
17 0 Sentry V, VII 


1 Sentry VIII 
16 0 4range PMU 

1 6 range PMU 
2.3.3 SELP (SYSVAR + 2) 


Contains the line printer type indicator: 


0 | Data Products/Printronix 80 column 
1 Data Products 132 column 
2 Centroniecs/Printronix 


If the system is called from DOPSY, SELP is set to the type used by DOPSY. 
MASTR default is 2. 


2.3.4 MIWSWC (SYSVAR + 3) 


Contains the number of words available in disk working storage and is set when 
the system is loaded from DOPSY. 


2.3.9 M1WSSC (SYSVAR + 4) 


Contains the number of sectors available in disk working storage. 


2.326 MIWSDA (SYSVAR + 5) 


Contains the starting address of disk working storage in binary sector format. 


2.3.7 M1IFDDA (SYSVAR + 6) 


Contains the starting address of disk directory in binary sector format. 


2.3.8 M1FDA (SYSVAR + 7) 


Contains the starting address of disk file area in binary sector format. 


2.3.9 SYSINT (SYSVAR + 9) 


Contains the starting address of monitor upon bootstrap. 


A. 
“% 


2.4 


GLOBAL VARIABLES 


A listing of global variables appears in figure 2-3. 


00420 
o0421 
00422 
00423 
00424 
00425 
00426 
00427 
00430 
00431 
00432 
00433 
00434 
00435 
00436 
00437 
00440 
O0441 
00442 
00443 
ona4aa 
00445 
00446 
00447 
00450 
00451 
00452 
00453 
00454 
00455 
00456 
00457 
090460 
00461 
00462 
00463 
00464 
00465 
00466 
00467 
00470 
00471 
00472 
00473 
00474 
00475 
00476 
00477 
00500 
n05o1 
00502 
00503 
00504 
00505 


00000420 


00000220 
00000420 


00000000 
900000000 
00000000 
00000000 
21211721 
22172730 
0N000N00 
00000000 
00000222 
90000000 
00000062 
00000000 
00000010 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000015 
00000000 
00000000 
00000001 
77777777 
00000022 
00000024 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
90000000 
00000000 
90000000 
009000000 
00000000 
00000000 
00001503 
00000022 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000C00 
00000000 


Figure 2-3 


* 

* GLOBAL 
* 

NGLOV 

* 

GLOVAR 

* 

ATPA 


RELDAT 


SITEAQN 
APMREV 
NTVT 
TvT 
NSVT 
SVT 
NMAC 
FwMAC 
LWMAC 
STAVKT 
PYDPMF 
PODPMF 
DRPMF 
FWALT 
LWALT 
FWINA 
NIOA 
CURSYS 
FGRGFL 
REVN 
JOB 
TPHL 
OPHL 
DATE 


TIME 
PGPMF 
LWCPU 
LWSYS 
LWAM 
FWAM 
ADJFLG 
THDACT 
PIDFLG 
ECHFLG 
COMIMG 
CMDPMF 


OCTAL 
OFLERR 
LDFLG 
MANTISSA 
CMDV 
NAMEM1 
NAMEM?2 
BINUM 
BINC 


PAGE 
ORG 


4208 


VARTABLES FOR USE BY OVERLAYS 


EQU 
EQU 


DATA 
DATA 
DATA 
DATA 
TEXT 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


DATA - 


DATA 
DATA 


144 
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0 
Q 
0 
( 
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0 
0 
0 
0 
0 


0 
0 
0 
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Global Variables Listings 


# OF WORDS IN GLOVAR 


STAT1 TEST PLAN ATTACHED TO STATION 
MACTAB POINTER FOR TP 
NONE ATTACHED 
BEING EDITED 


N 
0) 
1 STAT2 + = 
2 STAT3 0 = 
3 STAT&Y #= = 
4,5 
6 STATION ON LINE (06) 


REV OF APM SOFTWARE 


8 


# OF VARTIABLES/STATION IN TVT TABLE 


TVT TABLE ADDRESS 


# OF VARIABLES IN SVT TABLE 


SVT TABLE ADDRESS 


# OF WORDS/ENTRY IN MACTAB 


MACTAB ANDRESS 


LAST USED ADDRESS+1 MACTAR 


DEFAULT VKT FOR ALL STATIONS 


PIN ENTRY ADDRESS IN IOATAB 
POD ENTRY ADDRESS IN IOATAB 


DISC NIRECT ENTRY ADDRSS IN IQATAB 
FIRST ADDRESS OF ALTER BUFFER 

LAST USED ADDRESS +¢1 OF ALTRUF 
FIRST ADDRESS OF IOATAB 

# OF WORDS/ENTRY IN IOATAB 


CURRENT SYSTEM, 


O=BG, 


1=FG 


1=BG WAIT FOR FG,22FG WAIT FOR RBG 
CURRENT REV NUMBER 
CURRENT JOB NUMBER 
TEST PLAN HEADER LENGTH 
OVERLAY HEADER LENGTH 


CURRENT DATE 


CURRENT TIME IN SECONDS 


PAGE PMF POI 


NTER 


CPU LAST AVATLABLE WORD 
LAST SYSTEM RESERVED WORD +1 
LAST AVAILABLE WORD TO TP, 


FIRST AVAILABLE WORD TO TP, 
FOR MEMBSY 


ADJMEM WAITI 
FG ON/OFF FL 


NG 
AG 


OVERLAY 
OVERLAY 


COMMAND ALREADY IN BUFFER FLAG 


ECHO FLAG FOR PROCESS 
COMMAND IMAGE FROM PROCESS 
»CMDBUF,18 42 PMF FOR SYSTEM COMMAND 


OCTAL VALUE 


DECIMAL APPEARED IN INTSCN 


LOAN TS BUSY 


OF INTSCN 


FLAG 


INTEGER VALUE FROM NUMBER 
DEVICE CONDE FROM PROCESS 


1ST 


STRING FROM PROCESS 


BINARY VALUE FROM INTSCN/NUMBER 
BINARY COUNT FORM INTSCN/NUMBER 


RELEASE DATE (SYSREL HAS RELEASE #)- 


00506 

00507 

00510 

ooS11 
x 00512 
x 00513 
« 00514 
¥00515 
*00516 
*x00517 
° 00520 
005A! 
' 00822 
' 00523 
00524 
- 00525 

00526 
~ 00527 
© 09530 
, 00531 
— 00532 
“ 00533 
00534 
~N0535 
00536 
00537 
00540 
00541 
00542 
00543 
00544 
00545 
00546 
00547 
00550 
00551 
0055e2 
00553 
00554 
00555 
00556 
00557 
00560 
00561 
00562 
00563 
00564 
00565 
00566 
00567 
00570 
00571 
00572 
00573 
00574 


% 


00000000 
00002261 
00000000 
00000000 
00000000 
90000000 
90000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
00000000 
09000000 
00000000 
00000000 
00000000 
00000000 
00000009 
00000000 
00000000 
00000000 
00000000 
00002263 
00002264 
00000000 
00000900 
00000000 
00000000 
00000000 
00000000 
00001561 
00000000 
00000000 
09000000 
00017725 
00000100 
00002301 
22162100 
00000000 
00000000 
00000000 
00000000 
00000000 
009000000 
00000000 
90000000 
00000000 
00000000 
00000000 
00000000 
90000000 
00000000 
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COLFLG 
RSTIOA 

ACTFIO 
MEMBSY 
NAMEMS 
NAMEM6 
NAMEM3 
NAMEMYG 
ONUMB1 
ONUMB? 
NUMBI 

NUMB2 

STATC 

SPNUM1 
SPNUM2 
SPNUM3 
SPNUIMY 
SPNUMS 
SPNUM6 
BINARY 
INUMB] 
INUMBK2 
BFLERR 
SPOPT 

RBINCNT 
AWATF 

ATHDF 

NUMFLG 


NAME J 
NAME? 


RAIDRR 
DBUGSA 
DFSTAT 
SMAFLG 
SPDA 

RAIDER 
RAID#K 
AFGRGF 
SYSREL 
MASTAT 
CLIOID 


LOTNUM 


DEVNUM 


CATGRY 


RSTTSC 
BGIND 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


DATA 


DATA 


DATA 


DATA 
DATA 


STIUF 


eooecoocooo oc co ccocoocococooxzeS 


WATSPD 


RUGS 


100B 


FEBGSC 
Veoh? 
0 

0,0 


0,0,0 


0,0 


0,90 


54 COLUMN FORMAT FLAG FOR PUTE 
SS RESET PENDING SCHEDULER FLAG 
So FGIO IS ACTIVE OR PENDING 

S57 MEMORY BUSY 

SA 3RD NAME FROM PROCESS 

S59 3RD NAME FROM PROCESS 

60 2ND STRING FROM PROCESS 


62 OCTAL NUMBER 1 FROM PROCESS 

63 OCTAL NUMBER 2 FROM PROCESS 

64 1ST DECIMAL # FROM PROCESS IN F,P, 
65 2ND DECIMAL # FROM PROCESS IN F,P, 
66 VALUE OF STAT N FROM PROCESS 

67 SPECIAL # FROM PROCESS 

68 SPECIAL # FROM PROCESS 

69 SPECIAL # FROM PROCESS 

70 SPECIAL # FROM PROCESS 

71 SPECIAL # FROM PROCESS 

72 SPECIAL # FROM PROCESS 

73 BINARY VALUE FROM PROCESS 

74 1ST INTEGER FROM PROCESS 

75 2ND INTEGER FROM PROCESS 

76 NOT BINARY FLAG FROM INTSCN 

77 SPECIAL OPTION FLAG FROM PROCESS 
78 BINARY DIGIT COUNT FROM PROCESS 

79 ADDRESS OF WAIT FLAG SCHEDULER 

80 ADDRESS OF THDFLAG SCHEDULER 

B81 NUMBER APPEARED FLAG FROM IDTSCN 


83 1ST NAME FROM INDTSCN 

B84 2ND NAME FROM IDTSCN 

85 SPARE 

86 RAID BREAKEE RR 

87 ADDR OF DEBUG ADDR HALT ROUTINE 
8& DEFAULT STATION ID 

89 MA STATTON CONTROL 

90 PD BUFFER RUSY FLAG 

91 ADDR OF RAID PG 0 LOGIC 
92 SAVE RAID'S RR HERE 

93 FGBGH SCHEDULER FLAG 

94 SYSTEM REL # IN ASCII 

95 MA STATION FOR CR REQUEST 
96 CLIO NAME1,2 


98 LOT # FOR CLIO. 


DEVICE # FOR CLIO 


CATEGORY FOR CLIO 


STSC REG IMAGE 
RACKGROUND ID 


106 
107 
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2.4.1 ATPA (GLOVAR + 0, 1, 2, 3) 

Contains the address of MACTAB for the test program attached to the station. 
ATPA + 0 station 1 

ATPA + I station 2 

ATPA + 2 station 3 

ATPA + 3 station 4 


Contains zero if a test program is not attached. 


2.4.2 RELDAT (GLOVAR + 4,5) 


Contains the release date of the operating system. 


2.4.3 SITEQQ (GLOVAR + 6) 


Contains the station number currently online. 


0 station 1 
] station 2 
2 station 3 
3 Station 4 
2.4.4 APMREV (GLOVAR + 7) 


Contains the APM F8 operating system revision number in TRASCII. 


9.4.5 NTVT (GLOVAR ¢ 8) 


Contains the number of variables available in the test head variable table TVT for 
each station. See the description of each variable in section 2.5. 


TVT table size is NTVT X 4 stations. | 


24.6 TVT (GLOVAR + 9) 


Contains the starting address of TVT table. Each station is allotted the same 
number of variables in the test head variable table. 


TVT t | 
Station 1 
Word (NTVT-1) 
Word (NTVT) 
Word NTVT+1 
: Station 2 
Word (2x(NTVT-1) : 
Station 3 
: (NTVT Words) 
Station 4 
(NTVT Words) 


2.4.7 NSVT (GLOVAR + 10) 


Contains the number of variables in the eurrent station variable table SVT. See 
the description of each variable in section 2.6. 


2.4.8 SVT (GLOVAR + 11) 


Contains the starting address of SVT table. 


2.4.9 NMAC (GLOVAR + 12) 


Contains the number of variables per entry in MACTAB. 


2.4.10 FWMAC (GLOVAR + 13) 


Contains the starting address of MACTAB. 


2.4.11 LWMAC (GLOVAR + 14) | 

Contains the last-used entry address +1 of MACTAB. Points to the first avail- 
able entry. If MACTAB is empty, LWMAC = FWMAC. When the table is full, 
LWMAC = LWSYS. 

2.4.12 STAVKT (GLOVAR + 15) 

Contains the IOATAB pointer of VKT initially assigned to all stations. If there 
are two VKTs in the system then VKT1 is used. 

2.4.13 PIDPMF (GLOVAR + 16) 

Contains the address of system PID entry in IOATAB from which the last eom- 
mand was entered. 

2.4.14 PODPMF (GLOVAR + 17) 

Contains the address of system POD entry in IOTAB from which the last com- 
mand was entered. 

2.4.15 DRPMF (GLOVAR + 18) 


Contains the address of disk directory entry in IOATAB. 


2.4.16 FWALT (GLOVAR + 19) 


Contains the first word address of ALTER buffer. 


2.4.17 LWALT (GLOVAR + 20) 

- Contains the last-used address of ALTER buffer +1. When the buffer is empty 
LWALT = FWALT. When the buffer is full, LWALT = TVT. 

2.4.18 FWIOA (GLOVAR + 21) 


Contains the first word address of I/O assignment table (IOATAB). 


2.4.19 NIOA (GLOVAR + 22) 


Contains the number of words per entry in IOATAB. 


2.4.20 CURSYS (GLOVAR + 23) 


Contains the indicator showing whether current operation is in foreground or 
background. | 


1 foreground 
0 background 


2.4.21 FGBGFL (GLOVAR + 24) 


A flag to indicate that background is waiting for a foreground breakpoint to exe- 
cute a memory move or vice versa. 


1 Background wait for foreground 
2 foreground wait for background | 


2.4.22 REVN (GLOVAR + 25) 


Contains the revision level of the system. 


2.4.23 JOB (GLOVAR + 26) 


Contains the current job number. 


2.4.24 TPHL (GLOVAR + 27) 


Contains the test program header size. 


2.4.25 OPHL (GLOVAR + 28) 


Contains the overlay header size. 


2.4.26 DATE (GLOVAR + 29, 30) 


Contains the current date entered by the command: DATE. Any eight-character 
presentation of date is stored. | | 


2.4.27 TIME (GLOVAR + 31) 


Contains the current time in seconds initialized by the command: TIME. It is 
updated every time a clock pulse occurs. 
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2.4.28 PGPMF (GLOVAR + 32) 

Contains the address of IOATAB where the entry is reserved for the test program 
paging. 

2.4.29 LWCPU (GLOVAR + 33) 


Contains the highest CPU memory address. 


2.4.30 LWSYS (GLOVAR + 34) 


Contains the highest address reserved by the system +l. 


2.4.31 LWAM (GLOVAR + 35) 


Contains the last available memory address for overlays, test programs, and other 
memory files. The area above this is used for stack. If there is no stack, LWAM 
equals LWCPU. 


2.4.32 FWAM (GLOVAR + 36) 

Contains the next available memory address for overlays, test programs, and 
other files which may be resident in memory. When there are no files in 
memory, FWAM equals LWSYS. 

2.4.33 ADJFLG (GLOVAR + 37) 


Contains the flag indicating that the ADJMEM subroutine is waiting for DMA to 
memory to complete before doing a memory move. Reserved for system use. 


2.4.34 THDACT (GLOVAR + 38) 


Contains the test head active flag. It is set to 1 when THD is entered and cleared 
to 0 on exit. Entering the background to wait for tester activity does not affect 
the flag. This flag prohibits entering THD reentrantly. An overlay called from 
the keyboard that uses the tester may use the flag to control test head use. 


Example: 


ss program entry 


LDA | THDACT TEST HEAD AVAILABLE 

BZ *43 0 YES 

BSM# MONINT NO, WAIT 

BRU #3 RETRY 

LDA DI 

STA THDACT PREVENT OTHER TEST HEAD USE 
CLA 


STA THDACT 
= program exit 

2.4.35 §  PIDFLG (GLOVAR + 39) 

Reserved for use by the monitor to indicate that a keyboard eommanad is in 
a buffer and ready to be processed. 

2.4.36 ECHFLG (GLOVAR + 40) 

Contains a flag to PROCESS. 


2,0 Donot echo command. 
-] Echo command if input is not VKT. 


2 Process seans disk for command. 
l Noise words are acceptable. Do not sean disk. 
2.4.37 COMIMG (GLOVAR + 41) 


Contains the data formed by the PROCESS routine using the monitor com- 
mand table. Any key words appearing in the monitor command table are picked 
up, and the bit configuration provided for the key words are stored in COMIMG 
before any overlay is called. | | 

2.4.38 CMDPMF (GLOVAR + 42, 43, 44) 

The PMF header for the system command. Any record read by the monitor is 
stored in the buffer pointed to by CMDPMF. 

2.4.39 OCTAL (GLOVAR + 45) 


Contains octal value obtained by the INTSCN routine. 


2.4.40 OFLERR (GLOVAR + 46) 


A flag to indicate that a decimal digit 8 or 9 appeared during scanning a number 
in INTSCN. It is a nonzero when the above condition occurs. 


2.4.41 LDFLG (GLOVAR + 47) 


Set when LOAD is called. Overlays may not call LOAD unless this flag is clear. 


2.4.42 MANTISSA (GLOVAR + 48) 


Contains the integer value obtained by the NUMBER subroutine. 


2.4.43 CMDV (GLOVAR + 49) 


Contains the device codes obtained from a command by calling the PROCESS 
routine. Up to three input and three output device codes are saved. 


23 20 16 12 8 4 0 


Output 3 Input 3 Output 2) | Input 2 Output 1 | Input 1 


Device Input Output 
Code 

0 PID POD 

] TTK TTP 

2 MTR1 MTW1 
3 MTR2 MTW2 
4 CR LP 

5 DIF DOF 

6 CLI CLO 

7 VK2 VP2 

8 MIF MOF 


If no device is specified in a command it contains 0. 


2.4.44 NAMEM1, NAMEM2 (GLOVAR +50, GLOVAR +51) 

NAMEM3, NAMEM4 (GLOVAR +60, GLOVAR +61) 

NAMEM5, NAMEM6 (GLOVAR +58, GLOVAR +59) 
These cells are used to store string names appearing in a command during the 
execution of PROCESS routine. Up to six characters of the first string are stored 
in NAMEM2 left justified. The second string is stored in NAMEM3 and NAMEM4 
and the third string in NAMEM5, NAMEM6. 
2.4.45 BINUM (GLOVAR + 52) 


Contains the binary value obtained by INTSCN/NUMBER. 


2.4.46 BINC (GLOVAR + 53) 


Contains the binary digit count in BINUM. 


2.4.47 COLFLG (GLOVAR + 54) 


The THD sets this flag to control the output of engineering numbers by PUTE. 
Reserved for system use. 


2.4.48 RSTIO (GLOVAR + 55) 


Reset interrupt sets this flag if foreground I/O is in progress. Reserved for sys- 
tem use. 


2.4.49 ACTFIO (GLOVAR + 56) 


This flag is set when foreground I/O is in progress. Reserved for system use. 


2.4.50 MEMBSY (GLOVAR ¢+ 57) 


This flag is set when DMA to or from memory is in progress. It prevents memory 
moves. Reserved for system use. 

2.4.51 ONUMBI1, ONUMB2 (GLOVAR + 62, GLOVAR + 63) 

Contain octal form of numbers appearing in a command. The numbers are stored 


by the PROCESS routine. A one indicates that no or only one number appeared. 
Values are always absolute (signs are ignored). 
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2.4.52 NUMB1, NUMB2 (GLOVAR + 64, GLOVAR + 65) 


Used to store numbers that appear in a command during the execution of PRO- 
CESS routine. The first number to appear in the command is stored in the 
NUMBI1 and the second in NUMB2 in signed floating point format. A-l ina 
cell indicates that no or only one number appeared. 


2.4.53 STATC (GLOVAR + 66) 


Contains the decoded station identification appearing ina command. The 
deeoded form is 1, 2, 3 or 4. It contains -] when a station ID is not entered 
in the command. 


2.4.54 SPNUMI1, SPNUM2, SPNUM3, SPNUM4, SPNUM5, SPNUM6 
(GLOVAR + 67, 68, 69, 70, 71, 72) 


Used to store numbers that appear in a command in the identifier number batched 
form during execution of PROCESS routine. A number is stored to a specific cell 
as directed by the key number supplied by the user. A -1 in any cell implies 

no number. 


2.4.55 BINARY (GLOVAR + 73) 

Contains the binary value obtained by the subroutine PROCESS. The binary num- 
ber must have the format nnnn, where n is either 1 or 0. 

2.4.56 INUMBI, INUMB2 (GLOVAR + 74, 75) 

Contain values equivalent to NUMBI1 and NUMB2 in integer format. The first 
number that appears is placed in INUMBI and the second in INUMB2 by the 
subroutine PROCESS. These cells are initialized to -1. The values are always 
absolute (signs are ignored). 

2.4.57 BFLERR (GLOVAR + 76) 


A flag to indicate that the number seanned contains a digit greater than 1 and 
eannot be a binary number. It is set by INTSCN and checked by NUMBER routine. 


2.4.58 SPOPT (GLOVAR + 77) 


Contains special character flag bits set by PROCESS. If a special character is 
sensed during command sean, the defined bit is set in SPOPT. It is initialized to 
Zero. z a 


Bit Special Character 
14 a comma (,) is sensed 
0 a minus sign (-) is sensed 
l a plus sign (+) is sensed 
2.4.59 BINCNT (GLOVAR + 78) 


Contains the number of digits sensed for the binary number during number scan. 
The number is placed in the global BINARY. 


2.4.60 _ AWATF (GLOVAR + 79) 


Contains the address of scheduler wait flag. The flag must be set to 1 by the 
tester interrupt service if the wait condition is completed. AOM* AWATF 


2.4.61 ATHDF (GLOVAR + 80) 


Contains the address of scheduler flag for tester start. The flag must be set to 1 
by the tester interrupt service if the start interrupt occurs. AOM* ATHDF 


2.4.62 NUMFLG (GLOVAR ¢ 81, 82) 


A flag that indicates that one or more digits has appeared in an identifier. The 
first word contains the character-count (position of the first digit in the buffer) 
and the second word contains the starting character-count of the identifier. 
NUMEFLG + 1 is set for any identifier by $#PARSE. NUMFLG is set by IDTSCN 
only if a digit is sensed in the identifier. These cells are used by PROCESS 

to obtain the special numbers in the form of XXXnnn where XXX is an identifier 


and nnn is a number. 
{ 


2.4.63 NAMEI, NAME2 (GLOVAR + 83, 84) 


Contain the names or strings scanned by the routine IDTSCN. The maximum of 
eight characters is packed in TRASCII left justified. These cells are also used by 
SEARCH routine as input names to be searched in the table. 


2.4.64 RAIDRR (GLOVAR + 86) 


Reserved for system use by RAID to store a relocation register. 
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2.4.65 DBUGSA (GLOVAR + 87) 

Contains the address of DEBUG address halt entry point in the monitor. BSM* 
DBUGSA is placed in the user's program. 

2.4.66 DFSTAT (GLOVAR + 88) 

Contains the station identification entered by: SET STATn. It is a binary value 
of 1 through 4. It is used as the default station identification for processing 
commands that require STATn when a station number is not entered in the 
command. 


2.4.67 SMAFLG (GLOVAR + 89) 


Contains the station control information for test head driver issued by the user 
through manual analysis command. 


23 22 18 14 10 6 2 0 


Manual Start Single Step 


x] fatsf2|ifafafatijatst2tisfafsfa}ifaisfatyy | 


START Request for test start from MA (START or carriage 
return after MANUAL or STEP). Cleared by 
test head driver when accepted. 


SINGLE STEP MODE Request to single step (STEP). Cleared by MA 
upon MANUAL, CONTINUE, or STEP OFF. 


RESET Request to clear before test start (RESET) cleared 
by test head driver when accepted. 


DO NOW Request to call MA foreground immediately. (MEAS, 
READ, WRITE, DISP without 'ON'). Cleared 
by test head driver when accepted. START bit is 


also set. 
MANUAL START Request to start test with carriage return. Used 
MODE by MA only. Cleared by CONTINUE or MANUAL OFF. 


B23 When there is at least one pequect: of START or 
| DO NOW present. | 


2.4.68 RAIDER (GLOVAR + 91) 


Reserved for system use by RAID. 


2.4.69 ~ RAIDBK (GLOVAR + 92) 


Reserved for RAID during breakpoint execution. 


2.4.70 SPDA (GLOVAR + 90) 


A flag to indicate that parameter distribution overlay buffer area is busy when 
SPDA = 1. SPDA = 0 when it is not busy. 


2.4.71 AFGBGF (GLOVAR + 93) 


Reserved for system use. 


2.4.72 SYSREL (GLOVAR + 94) 

Contains the system release level in TRASCII that is printed by DIRECT and 
TE. It is patched by the system generation procedure. 

2.4.73 MASTAT (GLOVAR + 95) 

Contains the station ID used to start testing by entering a carriage return. It 
is set by MA upon MANUAL or STEP request. A 0 indicates no carriage return 
requests. Bit 23 set to 1 indicates VK2. Bits 2 to 0 specify station number 

(1 to 4). | : 

2.4.74 CLIOID (GLOVAR + 96, 97) 


Contains the six-echaracter file name entered in OPEN or USE command. 


2.4.75 LOTNUM (GLOVAR + 98, 99, 100) 


Contains the lot number used by the Integrator system. Before calling $IOCS to open a 
file in the Integrator system to output tester data, these cells must be set. 


2.4.76 DEVNUM (GLOVAR + 101, 102) 


Contains the device number used by the Integrator system; usage is the same as for 
LITNUM. | 
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2.4.77 CATGRY (GLOVAR + 103, 104, 105) 


Contains the category number used by the Integrator system. Usage is the same 
as for LOTNUM. 


2.4.78 RSTTSC (GLOVAR + 106) 


Contains the image of STST register when the reset interrupt occurred. 


23 14 10 0 


Bit Function 

10 Reset on station 1 

11 Reset on station 2 

12 Reset on station 3 

13 Reset on station 4 

2.4.79 BGID (GLOVAR + 107, 108) 


Can be set by overlays if a message END of XXXX is to be ouput upon overlay 
termination. BGID contains the program name XXXX. If it is zero, the message 
is not output. 


9.5 


A listing of tester variables appears in figure 2-4. 


TESTER VARIABLES 


PAGE 
* 
* 
* TEST HEAD VARIABLE TABLE EQU'S (TVT) 
x 
x ACCESSED BY INDEX TP(X2) 
* 
00000222 TVTL EQN 146 
* 
00001110 TVTLT Eau TVTL¢TVTIL+TVIL+TVTIL = 4 STATIONS 
* 
00000000 TSWITCH EQU 0 GLOBAL VARIABLE SWITCH 
00000001 TVALUE EQU 1 GLOBAL VARTABLE VALUE 
00000002 TSN FQU 2 GLOBAL VARIABLE SN’ 
00000003 TTT EQU 3 GLOBAL VARIABLE TT 
00000004 TDATAL EQU 4 DATALOG REQUEST 
00900005 TRTD EQU 5 ROUND TRIP DELAY 
* EQU 6 SPARE 
* EQU 7 SPARE 
* EQU 8 SPARE 
* EQU 9 SPARE 
* EQU 10 SPARE 
00000013 TGLORL EQU 11 GLOBAL VARTABLE GLOBI 
*TGLOB2 EQU 12 GLUBAL VARIABLE GLOB2 
*TGLOB3 EQU 13 GLOBAL VARTARLE GLOB3 
*TGLOB4 EQU 14 GLOBAL VARIABLE GLOR4 
*TGLOBS EQU 15 GLOBAL VARIABLE GLOBS 
*TGLOB6 EQU 16 GLOBAL VARIABLE GLOB6 
*TGLOB7 FQU 17 GLOBAL VARIABLE GLOB7 
*TGLOBS EGU 18 GLOBAL VARIABLE GLOBS8 
*TGLORO9 EQU 19 GLOBAL VARIABLE GLOB9 
*TGLOLO EQU 29 GLOBAL VARIABLE GLOB10 
*TGLOL1 EQU at GLOBAL VARIABLE GLOBI1 
*TGLO12 EQU 22 GLOBAL VARIABLE GLOR12 
xTGLO13 EQU 23 GLOBAL VARIABLE GLOB13 
*xTGLO14 EQU 24 GLOBAL VARIABLE GLOB14 
*TGLOIS EQU 25 GLOBAL VARIABLE GLOB15 
*TGLAL6 EQU 26 GLOBAL VARIABLE GLOB16 
*TGLU17 = EQU 27 GLOBAL VARIABLE GLOB17 
*TGLO1B EAU 28 GLOBAL VARTABLE GLOB18 
*TGLOI9 EQU 29 GLOBAL VARTABLE GLOBI9 
*TGLNA0D EQU 30 GLORAL VARTABLE GLOB20 
*TGLO21 EQU 31 GLOBAL VARIABLE GLOB21 
*TGLO22 EQU 32 GLOSAL VARTABLE GLOB22 
*TGLO23 EGU 33 GLOBAL VARIABLE GLOB23 
*TGLO24 EQU 34 GLOBAL VARIABLE GLOB24 
aTGLO25 EQU 35 GLOBAL VARIABLE GLOB25 
*TGLO26 EQU 36 GLOSAL VARIABLE GLOB26 
xTGLO27 EQU 37 GLOBAL VARIABLE GLOB27 
*TGLO2B EGU 38 GLOBAL VARIABLE GLOB28 
*TGLO29 EQU 39 GLORAL VARIABLE GLOR29 
*TGLO3ZO0 EQU 40 GLOBAL VARIABLE GLOB30 
*TGLO31 EQU 41 GLOBAL VARIABLE GLOB31 
*TGLO32 EQU 42 GLOBAL VARIABLE GLOB32 
*TGLO33 EQU 43 GLOBAL VARTA8LE GLOB33 
*TGLOS4 EQU 44 GLOBAL VARTABLE GLOB34 
*TGLO35 EGU 45 GLOBAL VARIABLE GLOB35 
*TGLO36 EQU 46 GLOBAL VARIABLE GLOB36 
*TGLO37 EQU = 47 GLOBAL VARIABLE GLOB37 
*TGLO3ZB EQU 4B GLORAL VARTABLE GLOB38 
*TGLO39 EMU 4g GLOBAL VARIABLE GLOB39 
00000062 TGELO4O EQU 50 GLOBAL VARIABLE GLOB4O 
* EQU 51 SPARE 
Figure 2-4 Tester Variables Listing 
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* 

* 

x 

* 

* 

* 

* 

* 

* 

* 
00000075 TINDEX 
00000076 TCPC 
00000077 TDCDLY 
00000100 TODLY 
00000101 TNOVER 

* 
00000103 TDLO 
00000104 TOLF 
00000105 TDLS 
00000106 TODLR 
00000107 TDLC 
00000110 TLMFC 
00000111 TPDF 
00000112 TPDS 
00000113 TPDR 
00000114 TDFR 
00000115 TMACTL 
00000116 TPPO 
00000117 TSYNC 

* 
00000121 TMOD 

* 
00000122 TAPMP1 
00000123 TAPMP2 
00000124 TAPMF1 
00000125 TAPMF2 

x 

* 

* 

* 

* 

* 

* 

* 
00000135 TPDD 
00000135 TVTLL 
00000136 TSTEP 
00000137 TPAUSE 
00000140 TIP 
00000141 TRINT 
00000142 TBINS 
00000143 TMPIN 

* 

* 

x 

* 

* 
00000150 TvTLG 
00000151 TPID 
00000152 TTTK 
00000153 TMTR1 
00000154 TMTR2 
00000155 TCR 
Figure 2-4 
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EQU 
EQU 
EQU 
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EQU 
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EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQu 
EQU 


SPARE 
SPARE 
SPARE 
SPARE 
SPARE 
SPARE 
SPARE 
SPARE 
SPARE 


BINNIG INDEX 
PROCESS CONTROL, PAUSE,SYNC 
DC TIME DELAY 
LM TIME OUT DELAY 
MA OVERRIDE 

SPARE 
DL OPTION & DEVICE 
DATALOG FREQUENCY COUNT 
DATALOG SKIP CONTROL 
DATALOG REQUEST 
DATALOG CONTROL & STATUS 
DATALOG ADDITIONAL FAIL COUNT 
PD FREQUENCY COUNT 
PD SKIP CONTROL 
PD REQUEST 
DCF REQUEST 
MA CONTROL 
MA PPM REQUEST 
MA SYNC COUNT 

SPARE 
PPM,LM MODULE NUMBER 


APM PROCEDURES #1 
APM PROCEDURES #2 
APM FILE NAME #1 


APM FILE NAME #2 


SPARE 
SPARE 
SPARE 
SPARE 
SPARE 
SPARE 
SPARE 
NIST COUNT 


END OF LOCAL CLEAR (// CLEAR STAT) 


PROGRAM STEP COUNT 
PROGRAM PAUSE COUNT 
INSTRUCTION POINTER 
BIN INITIALIZED 
BIN STATUS 
MAX PIN (DEFAULT = 60) 
SPARE 
SPARE 
SPARE 
SPARE 
SPARE 


END OF GLOBAL CLEAR (// LOAD STAT) 


PIN ADDRESS IN IOATAB 
TTK ADDRESS IN IOATAB 
MTR1 ADDRESS IN IOATAB 
MTR2 ADDRESS IN IOATAB 
CR ADDRESS IN IOATAB 


Tester Variables Listing (Continued) 
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00000156 TOIF EQU 110 DIF ADDRESS IN IOATAB 


x EQU 111 SPARE 
00000160 TvK2 Fau 112 - VK2 ADDRESS IN TOATAB 
00000161 TMIF Fau = 113 MIF ADDRESS IN IOATAB 
00000162 TPOD Fau 114 POD ADDRESS IN IOATAB 
00000163 TTTP FQU 115 TTP ADDRESS IN IOATAB 
00000164 TMTW1 EQU 116 MTW1 ADDRESS IN IOATAB 
00000165 TMTW2 EQu 117 MTW2 ADDRESS IN IOATAB 
00000166 TLP EAU 118 LP ADDRESS IN IOATAB 
00000167 TDOF Eau 119 DOF ADDRESS IN IOATAB 
00000170 TCLO EQU  =:120 CLO ADDRESS IN IOATAB 
00000171 TvP2 FQU 121 VP2 ADDRESS IN IOATAB 
00000172 TMOF Eau 122 MOF ADDRESS IN IOATAB 
00000173 TAPT Eau 123 TESTER OPTION CONTROL 
00000174 TATTA Eau 124 ATTACH FLAG 
00000175 TJOB EQu 125 STATION'S JOB NUMBER 
00000176 TMSTK  EQU 126 MAX STACK SIZE USED 
00000177 TOMSTK EQU 127 MAX STACK SIZE SPECIFIED 
00000200 TRTDS Eau 128 SAVE ROUND TRIP DELAY SO IT WONT BE CLEARED 

* EQU 129 SPARE 


00000202 TTITLE EQU 130 THRU 145 STATION TITLE 


Figure 2-4 Tester Variables Listing (Continued) 


2.5.1 TSWITCH (TVT + 0) 


Contains the value in floating point, either Epes mnie as the SWITCH variable 
or set by the command: ee 


2.9.2 TVALUE (TVT + 1) 


Contains the measurement value in floating point. It is set during execution of 
MEASURE VALUE, PIN, VARIABLE, and MACRO MEASURE PIN. 


2.5.3 TSN (TVT + 2) 


Contains the serial number in floating point either programmed as the SN variable 
or set by the command: SN. 


2.5.4 TTT (TVT + 3) 


Contains the test type programmed as the TT variable in floating point. 
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9.5.5 TDATAL (TVT + 4) 


Contains the floating point representation of the datalog request flag TDLR. It 
ean be accessed by the test program to override an operator requested option. 
The program may not turn on a request not specified by the operator. Any 
combination of bits may be entered. 


FCT Count 4010B 


FCT IFM 4020B 
EOT 200B 
LOG 400B 
MEAS 1000B 
DCT 2000B 
FCT 4000B 
TRIP 10000B 
2.5.6 TRTD (TVT + 5) 


Contains the floating point value of the round trip delay. It is added to the 
strobe values during program execution. It may be changed by a FACTOR program 
or displayed by the operator with the command: READ RTD. 


2.5.7 TGLOBI1 - TGLO40 (TVT + 11 - 50) 


Defined and used by the FACTOR programs and by ALLINK programs, and may 
be set or displayed by the command: GLOB. 


2.5.8 TINDEX (TVT + 61) 


Contains the count of number of times BIN specification has been updated. 


2.5.9 -TCPC (Command Processor Control) (TVT + 62) 


232 | 16 7 0 


ptt xtxtxdxtxt TE ETT TT ETP PPT et To 


Bit Description 

20 Pause on statement number requested 

19 Pause on fail requested 

18 Syne on statement number requested 

17 Syne on ADDR 

16 | Syne on COUNT (TSYNC contains COUNT value) 
15 to 0 Statement number 


Set by manual analysis and used by THD. 


2.5.10 TDCDLY (DC time DeLaY) (TVT + 63) 


Bit Description 
23 Modify active (do not use programmed value) 
13 to 0 DC time delay value 
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9.5.1] TODLY (Time Out)(TVT + 64) 


23 20 0 


E! Time Out Value 


GE te eed ee ie Ne a 


Bit Description 
23 Modify active (do not use programmed value) 
19 to 0 Time out value 


TDCDLY and TODLY are set by MA when MODIFY commands are entered. 
These cells are cleared when MODIFY OFF, CLEAR, or LOAD command is 
entered. 


2.9.12 TOVER (OVERride) (TVT + 65) 


23 19 0 


Pixbppt ET EEE ETE tt tt tet ee 


Bit Description 

22 Override on TRIP 

21 Override on FCT ALL 
20 Override on DCT 

19 Override on RESET 
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9.5.13 TDLO (TVT + 67) 


Contains the DATALOG devVice code. 


Bit Description 
22 Top of form on line printer 
3 to 0 Device Code 


Station POD 


NIOTRPWNH © 
Co 
rg 


2.5.14 TDLF (TVT + 68) 


Contains the DATALOG frequency request. Set by FRQn option to DATALOG 
command. If any log option is specified, this cell is cleared or set to the value 
specified by FRQn. TDLS is cleared to cause the first device to log. 


2.5.15 TDLS (TVT + 69) 
Running variable for the DATALOG frequency. It is initialized to zero and 


DATALOG overlay is ealled only when this is zero. At-the end of a test, it is 
reset to TDLF or decremented to control datalogging. 


2.5.16 TDLR (DataLog Request) (TVT + 70) 


Bit Description 


12 DPS trip log requested TRIP 
1] Functional fail log requested FCT 
10 Measurement fail log requested DCT 
9 All measurement log requested MEAS 
8 MEASURE LOG statement log requested LOG 
( EOT log requested | EOT 
6 Reserved for future use 
5 Ignore fail mode (B11 also set) IFM 
4 Count requested (B11 also set) COUNT 
3 Spare 
2 Spare 
1 DATALOG OFF requested 


Set by DATALOG in background based on the parameters entered in DATALOG 


command. 
2.5.17 TDLC (DataLog Control and status) (TVT + 71) 
23 22 20 19 17 16 13 6 0 


Pit Tt txt xt xp fpf TEE ET 


Bit Description 
23 Datalog active (set when TDLS = 0) 
19 Time-out fail (bit 11 also set) 
16 Reserved for Sentry VII development 
12 Log trip fail 
1] Log functional fail 
10 Log measurement fail 
9 Log all measurements 
8 Log only measure long 
7 Log EOT 
6 Reserved for future use 


2.5.18 TLMFC (TVT + 72) 


Contains the additional fail request on a local memory load. It ean be set by © 
entering the additional number in the DATALOG command. When it is not zero, 


the specified number plus one or all fails, whichever is less, is datalogged. 
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9.5.19 TPDF (TVT + 73). 


Contains the DIST frequency request. 


2.5.20 TPDS (TVT + 74) 


Similar to TDLS and used to keep track of skipping DIST ealls. 


2.5.21 TPDR (TVT + 75) 


A DIST request flag. When it is not zero, DIST is considered active and DIST 
overlay is called for data collection. 


2.5.22 TDFR (TVT + 76) 


A DCF request flag. When it is not zero, DCF is considered active, and the DCF 
overlay is called for data collection. 


2.5.23 TMACTL (TVT + 77) 


Used to indicate manual analysis requests to foreground from background. 


Do Later Do Now 
Request pequest 


xt PPE TE PE EE EE xd xdxpod Pp Ppp xp x) 


Bit 23 Requests test head driver to enter MA foreground. 
Turned on by MA upon request. Turned off when 
there is no request for the next PAUSE and by the 
eommand CLEAR. 


DO LATER REQUEST Do the function at next PAUSE 


Bit Description 
10 WRITE 
9 DISPLAY 
8 READ 
7 MEASURE 
DO NOW REQUEST Do the function immediately 
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Bit Description 


3 | WRITE 

2 DISPLAY 

| READ 

0 MEASURE 
2.5.24 TPPO (TVT + 78) 


Bit Description 

23 LOOP or STOP ON 
Aes LOOP 

21 STOP 

5 to 0 PPM address 


Contains MA request for LOOP/STOP ON PPM memory address. 


2.5.25 TSYNC (TVT + 79) 

Contains 24-bit count for MA SYNC ON COUNT request. 

2.5.26 TMADSP (TVT + 80) 

Used to indicate the Manual Analysis DISPLAY requests. DISPLAY ALL sets 


bits 14 to 20. DISPLAY TIME sets bits 12, 13, 19, and 20. 


23-21 | 12 | 0 


etd Pepe px Pefx pep px PEE EE EEE Trt 


Bit Description 


20 TG 
19 STRB 

18 CLK 

17 PWR 

16 EIR 

15 FCT 

14 PMU 

13 SCRAM (ETM) 
12 TVn (ETM) 
2.5.27 TMOD (TVT + 81) 


Contains the current module number loaded to the PPM memory. 


2.9.28 TAPMP1, TAPMP2 (TVT + 82, 83) 


Contains the APM procedure download control. Each procedure executed by APM 
is assigned a VECTOR NUMBER by the FACTOR compiler. As each procedure is 
downloaded to APM, a bit is set in the appropriate control word designating that 
this procedure is now loaded. A maximum of 48 procedures may be sent to APM 
from any FACTOR program. 


TAPMPI1 Bits 23 to 0 represent procedures 47 to 24. 
TAPMP2 Bits 23 to 0 represent procedures 23 to 0. 
2.5.29 TAPMF1, TAPMF2 (TVT + 85, 86) 
Contains the APM file download control. Each APM procedure file is assigned a 
unique file number by the FACTOR compiler. As each procedure file is processed 
by the APM test head driver, a bit is set in the appropriate control word 
designating that the file is complete. (It will not be processed again.) A maxi- 
mum of 48 procedure files may be processed. 
TAPMFI1 Bits 23 to 0 represent APM procedure files 47 to 24, respectively. 
TAPMF2 Bits 23 to 0 represent APM procedure files 23 to 0, respectively. 
2.5.30 TPDD (TVT + 93) 


Set by DIST to indicate that histogram data is in memory. , 


2.5.31 TVTLL (TVT + 93) 


The TVT buffer from 0 through TVTLL is cleared by the CLEAR STATn command. 
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2.5.32 TSTEP (TVT + 94) 


Contains the actual number of manual halts which occurred during a test. Used 
to determine if the test is a re-execution due to another station execution. 


2.9.39 TPAUSE (TVT + 95) 


Contains the actual number of PAUSES that occurred during a test. Used to 
determine if the test is a re-execution due to another station execution. 


2.5.34 TIP (TVT + 96) 
Contains the current instruction number by counting every code as one instruc- 


tion. It is not the statement number. The header is included; therefore, at 
the beginning of the test, it is initialized to the length of the header. 


2.5.35 TBINT (TVT + 97) 


Used to indicate that the binning test is initialized or the specification 
has been updated. 


Bit Description 

23 Specification has been updated by UPDATE INDEX 
0 Binning test is initialized 

2.5.36 TBINS (TVT + 98) 


Used to indicate binning is active for the station. Bit 23 set to one indicates 
that binning is active. 7 
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2.5.37 TMPIN (TVT + 99) 


Used to save the maximum pin number set by the test program with SET MPIN. 
If none is set, the default is 60 for a Sentry VII and 120 for a Sentry VIII. 


23 12 8 0 


et Number of Pins 


TTT TT TITEL TPT ttt ety eee et dT 
Bit Description 

11 to 8 Number of ranks allowed 

7 to 0 Number of pins allowed 

2.5.38 TVTLG (TVT + 104) 


The TVT buffer from 0 through TVTLG is cleared by the LOAD STATn command. 


2.5.39 TPID, TTTK, TMTR1, TMTR2, TCR, TDIF, TVK2, TMIF (TVT 
+ 105 - 113) 
TPOD, TTTD, TMTW1, TMTW2, TLD, TDOF, TCLO, TVP2, TMOF 
(TVT + 114 - 112) 


These cells are used to do I/O from FACTOR and datalog output. When the cells 
have bit 22 set to 1, usage of these devices requires an OPEN command and 
datalog OUTPUT is in binary format. Bits 17 to 0 contain the address of IOATAB 
if the device has been opened. 


If bit 22 is set and bits 17 to 0 are zero at the time of usage, then a terminal 
error is issued. 


If bit 22 is zero and bits 17 to 0 are zero, an OPEN eall to $IOCS must be issued 


by the user and the address of IOATAB returned in X6 must be placed in the 
cell so that the device need not be opened for a following usage. 


2-38 


These cells ean be located by calling GTTDV subroutine (SY XVEC + 33) and 
properly updated by calling FGOH and FGIO (SYXVEC + 72, 70) for doing I/O. 


TPID/TPOD 


23 22 18 0 


HDR Code Address of IOATAB 


ix} TE TT Te EE EEE ET EEE ET TT ET 


Bit 22 = 1 For USE [MTR1/MTR2/MTW1/MTW2/DIF/DOF/CLO] STATn. 


Bit 22 = 0 For no USE command (when using system PID/POD) or for 
USE [TTK/TTP/LP/CR/PID/POD/VK2/VP2] STATn. 


It is reset to system PID/POD upon CLEAR or LOAD STATn by closing the 


file previously used. 


TTTK/TTTP/TCR/TLP/TTTK2/TTTP2/TVK2/TVP2 


23 22 18 0 


Address of IOATAB 


It is cleared to zero upon CLEAR or LOAD STATn 
TMTRI/TMTR2/TDIF/TMTW2/TDOR/TCLO/TMIF/TMOF 
The address is cleared to zero upon CLOSE command. These cells are not 


cleared (closed) upon CLEAR or LOAD STATn unless the device is opened by 
USE command. 


23 22 18 | 0 


po Address of IOATAB/O | 


pe ee ee ee Be | 
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HDR CODE indicates which data type was last output to this device. 


Bits 21 to 18 


Last header issued code 


0 None 
1 Trip 
2 

3 Spare 
4. FCT 
2 spare 
6 Spare 
7 PPM 
8 

9 


PPM, DATA EXTENSION 
FACTOR WRITE/FACTOR PAUSE 


Measure/Measure; | Log/Measurement Fail 


The command OPEN normally sets binary devices, and the USE command sets 
TPID/TPOD. When the USE command is entered for a binary device (e.g. USE 
CLO 'name'), the corresponding cell (TCLO) is checked to see if the device is 


open. The same check is done at OPEN command so that the same device can be 


opened only once by a station. 


2.0. 
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TOPT (TVT + 123) 


Used to save hardware option. It is set during system initialization (after boot 


from magnetic tape or entered from DOPSY) and is never cleared. 


23 


17 


Definition 


es 
Zee 


PLL txt xt xd xp pepepx px dxf x pp x Px pepe 


Obtained From 
Reserved for Sentry VII —-~~*ssible /1/3 Charest 
development ( 
6 Range PMU ee | 
Sen try VI ————— ee eo CAE AS O€ Fore, 
ETM Bit 3 SAMC 


28 volt swing 

Low voltage 

New REF/MUX module 
2V/2mV Option 

SPM 

PPM 

10 MHz head 

LM size (number of 
thousands of words) 


Bit 18 mode register 
Bit 17 mode register 
Bit 15 mode register 
RVS range bit 

Bit 8 SAMC 

Bit 7 SAMC 

Bit 6 SAMC 
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5*20 
Data fron Ln 
SOUrey ELE. 


ITRA 


2.5.41 — TATTA (TVT + 124) 


The overlays Binning, DCF, and PD are flagged that the LOAD STATn has taken 
place. LOAD sets the flag equal to 7. When the bit is set, the overlay prohibits 
new data for the current test program being added to data for the previous test 
plan. Before these overlays can be recalled any old data must be deleted. The 
overlays reset their respective bit when this oceurs. 


Bit Description 

0 Binning 

] DC failure analysis 

2 Parameter distribution 
2.5.42 TJOB (TVT + 125) 


Contains the job name of the test program attached to the station. This allows 
the user to change stations for background use. During test program paging 
and EXEC assembly language overlays, the station job is searched, rather than 
the current job. 

2.5.43 TMSTK (TVT + 126) 

The maximum size that the run time stack reaches during execution. If the 
stack is foreed beyond 500 words a message is printed at end of test: STATION 
n REQUIRED x WORDS OF STACK. 

2.9.44 TOMSTK (TVT + 127) 


Contains the stack size required by the test program. 
2.5.45 TRTDS (TVT + 128) 


Saves the round trip delay. TRTDS restores TRTD by the CLEAR and LOAD 
STATn commands. 
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9.5.46 TTITLE (TVT + 130 - 145) 


Contains the TRASCII station title entered by the user. It oe whenever 
the station header outputs. 
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2.6 


CURRENT STATION VARIABLES (SVT) 


A listing of current station variables appear in figure 2-5. 


00000062 


60000000 
00000001 
00000002 
00000003 
00000004 
00000005 
00000006 
00000007 
09000010 
90000011 
00000012 
00000013 
00000014 
00000015 
00000016 
00000017 
00000020 
00000021 
00000022 
00000023 
00000024 
90000025 


00000026 
00000027 
00000030 
00000031 
00000032 
00000033 
00000034 
00000035 
00000036 
00000037 
00000040 
90000041 
00000042 
00000043 
90000044 
00000045 


00000046 
00000047 


M+ + & HN 


* 


S488CT 
SAPMCT 


PAGE 


CURRENT STATION VARIABLE TABLE SVT 


ADDRESSED BY INDEX SP(X1) 


EQU 


EQU 
E QU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
ENU 
EQU 
FQU 
EQU 
EAU 
EQU 
EAU 
EQU 
EQU 


EQU — 


EQU 
FQU 
EQU 
EQU 


EQU 
EQU 
EQU 
EQ) 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 


EQU 
EQU 
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CUNO U SEWN 3 


ONeLINE SITE 


TEST HEAD CONTROL 


CURRENT PMU PIN NUMBER 

CURRENT PMU MEASUREMENT 

MEASURE FLAG FOR DL 

EIR IMAGE 

TERMINAL ERROR FLAG 

VOFFSET VALUE 

LOCAL MEMORY LOCATION 

DPS TRIP STATUS 

TEST PLAN ADDRESS 

SAVE MEASUREMENT IN REG FORMAT FOR MA 
INC ENABLE FLAG 

FORCING VALUE FOR MACRO 

LOCAL MEMORY PAGE SIZE 

PROGRAM MODE (PPM/SPM,ETC) 

DL ADDITIONAL FAIL FLAG 

IF COUNT FOR DL BY COUNT 

IF COUNT FOR MA SYNC, SET IF 

MODE OF MEASUREMENT =SET PMU SENSE 
MODE OF FORCE = SET PMU FORCE 

CLAMP BIT (28 VOLT SWING) FOR SAMC, ANY WRITE 
TO SAMC SHOULD OR IN THIS GLOBAL, EXCEPT 
ANALYSTS. 

ORIGINAL VALUE OF Q@ REG 

ORIGINAL VALUE OF QL 

LIMIT 0 OR LIMIT IF ONLY ONE 

LIMIT 1 WHEN THERE ARE 2 LIMITS 
ENABLE DCTO FLAG WORD 

ENABLE DCTO VALUE 

ENABLE DCT1 FLAG WORD 

ENABLE DCT1 VALUE 


ENABLED LIMIT VALUE 
ENABLE IHI 


ENABLE VLO 
ENABLE VHI 


488 BUS CONTROL WORD 
APM CONTROL WORD 


Figure 2-5 Current Station Variables Listing 


2-43 


2.6.1 SITE (SVT + 0) 

Current station number (0 to 3). Set to minus one on entry to the operating sys- 
tem. It is used when a station comes on line to determine if the start is for the 
same station as the previous start. 


0=STATI, 1 = STAT2, 2 = STATS, 3 = STAT4 


2.6.2 STHC (Test Head driver Control) (SVT + 1) 


23 ; 16 13 ee: 3 0 


Statement Bits _ —_ | Seq Bits | Test Bits 


Bit Description 
23 One or more of the ‘itowing bits are set 
22 Tester busy complete 
21 Time out interrupt - FCT fail 
20 Instruction number. compare interrupt 
19 | Fail occurred (bits 21, 16,12, 11, or 10 are set) 
18 '. Pause statement executed a 
17 DC interrupt oeeurred (DC measure or DCT) 
16 Reserved for nen Vil development 
15 to 13 Spare 
12 TRIP - DPS TRIP FAIL interrupt 
i Functional fail interrupt | 
10 DC fail - measurement fail — 
9 Measurement executed | 
8 Measure, LOG executed 
7 EOT | 
6 Reserved for D/L expansion 
5 to 3 SEQ bits 
2 to 0 TEST bits 
5,2 FC fail 
4,1 DC fail 
3,0 Trip fail 


Statement bits are cleared at the end of each statement execution. 


SEQ bits are cleared at the end of each sequence and by the CLEAR FAIL state- 
ment. They are displayed to the EIR lights at the end of each sequence. 
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TEST bits are displayed at the end of each test and cleared by the CLEAR FAIL 
statement. 


2.6.3 SPIN (SVT + 2) 


Contains the pin number that the PMU is connected to following an interpretive 
CPMU PIN, or the pin measured following an interpretive measure or a macro, or 
a DMA measure. This is logged even though the PMU may be disconnected, as 
after measure node, or connected to a rest pin, as after a macro. . 


2.6.4 — SMSR (SVT + 3) 


Contains the floating point value measured following an interpretive measure or a 
DMA measure which is logged. The voltage offset value programmed is added to 
the measurement value in SMSR. 


2.6.5 SMF (SVT + 4) 


23 | 14 13 10 9 8 6 


xP ttt te tt tt txt xp pte xt Pop tT dx 


Bit Description 

23 For MEASURE VARIABLE 

13 Mode of measurement 0 = current, 1 = voltage 

12 to 10 Range of SMSR | 

a) If two limits enabled it contains pass/fail for SLIMO 

= ] SLIMO failed 
= 0 SLIMO passed 

8 LT/GT for SLIM] LT =0, GT=1 

5 LT/GT for SLIMO LT = 0, GT=1 

1,0 Number of limits (0,1,2 

2.6.6 SEIR (SVT + 5) 


Contains EIR register information to be displayed. SEIR is written to the EIR 
register at the sequence halt (MANUAL, PAUSE, ete.) at the end of each test 

and at the terminal error. Any program writing to the EIR should put the value in 
SEIR. 
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Bit — Description 


14 End of test 

13 Functional test pass 

12 Functional test fail 

1] DC/TRIP test pass 

10 DC/TRIP test fail 

9 to 0 User written information or binning gates if used. 


At a terminal error, bits 11 and 10 are on and bits 9 to 0 contain the ceeminet 
error number. 


2.6.7 STEF (SVT + 6) 


Contains the terminal error number. See the terminal error list for currently © 
available error numbers. 


2.6.8 SVOFFS (SVT + 7) 


Voltage offset value is stored here in floating point format. All are zero if no 
offset is programmed. 


2.6.9 SLML (SVT + 8) 


Contains the delayed memory address needed by the DATALOG overlay in order 
to obtain the functional data from the local memory. 


23 12 | 0 


2-46 


2.6.10 STRIP (SVT + 9) 


Contains the failed DPS number needed by the DATALOG overlay. The interrupt 
service for TRIP FAIL sets this information. 


23 12 1110 9 0 


PEP PE ET TEE ET Ext EE 


Bit Failure 
11 DPS3 TRIP 
10 DPS2 TRIP 
l DPS1 TRIP 
2.6.11 STPP (SVT + 10) 


Contains the pointer to the absolute address of the test program for the station 
currently online, It points to one of the four ATPA cells when a test station is 
online. 


2.6.12 SMSRH (SVT + 11) 


Contains the results of a measurement following any MEASURE statement except 
MEASURE variable. The value does not have the programmed voltage offset 
added back as SMSR and TVALUE do. Bits 0 to 10 contain the measurement; 

bits 11 to 14 contain the mode and range from the PSL. 


2.6.13 SINC (SVT + 12) 

Flags test head driver to set the INC interrupt enable following a statement. 
After a station start request following a pause on statement number the IND is at 
the value which causes an interrupt. This interrupt is thrown away. After the 
IND is bumped by the next statement, SINC indicates that the INC interrupt 
enable should be turned back on. 


2.6.14 SFVAL (SVT + 13) 


Contains the value of the PPS register at the time of the last SET TEST number. 
It is used by DC MACRO processing and analysis. 
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2.6.15 SPG (SVT + 14) 


An indicator that tells if the currently running program contained a SET PAGE 
statement. If there is no SET PAGE, it is zero. Otherwise, it contains the local 
memory size specified by SET PAGE. 


2.6.16 SPMOD (SVT + 15) - 


Bit Description 


2V/2mV program 

SPM program 

PDMA (SET PERIODi is DMA) 

ETM program 

APM program 

488 Bus program 

6 range PMU program 

Sentry VIII program 

Set PPM ON programmed; do not reset bit 0 
REXEC executed or SET PPM ON, D/L treats a functional failasa 
PPM fail 


Om Dw © —R FIO -~1 CO cO 


2.6.17 SDLAF (SVT + 16) 


SDLAF is non-zero when additional fails are being logged. This controls the 
datalogger output. 


2.6.18 SIFC (SVT + 17) 
IGNORE FAIL register caine used to save last location during additional datalog 


fails. 


2.6.19 SIFV (SVT + 18) 


IGNORE FAIL value set by SET IFAIL instruction and syne by count or ADDRESS. 
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2.6.20 SMR (SVT + 19) 

The sense mode and range of the PMU set by the SET PMU SENSE statement is 
stored here. | 

Bit Description 

14,12,11 range 

0 AUTO 

2.6.21 SFR (SVT + 20) 


The force mode of the PMU set by the SET PMU FORCE statement is stored 
here. 


Bit Description 

13 mode 1 = voltage 
14,12,11 range — 

0,1 AUTO 

2.6.22 SSAMC (SVT + 21) 


Contains the value of bit 0 of SAMC for 28 volt swing. 


Bit 0 = 1 Indicates that the reference voltage supplies are clamped at -22 
volts. | | | 
Bit 0 = 0 Indicates that the reference voltage supplies are clamped at -16 


~ volts. This occurs when a period is less than 200 ns. 


2.6.23 SQ (SVT + 22) 


Contains the original value of Q from the SET Q statement. | 


2.6.24 © SQL (SVT + 23) 


Contains the original value of QL from the SET Q statement. | 


2.6.25 SLIMO (SVT + 24) 


Contains the ENABLE DCTO limit if two limits have been enabled for a 
measurement, or it contains either the DCT0, DCT1, or SET DCT limit if only one 
is enabled. The voltage offset has been added if it was programmed. This is the 
value printed by the datalogger. The value is in floating point. 
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2.6.26 SLIM1 (SVT + 25) 

Contains the ENABLE DCT1 limit if two limits have been enabled for a measurement. 
The voltage offset has been added if it was programmed. This is the value 

printed by the datalogger. The value is in floating point. 

2.6.27 | SDCTOE (SVT + 26) 


Flag word for ENABLE DCTO0 


Bit i a 
0 never enabled or disabled 
-] disabled 
0 1 enabled 
13 LT/GT flag 0 = LT, 1 =GT (DCT0/DCT1) 
2.6.28 SDCT0 (SVT + 27) 


Value of ENABLE DCTO in floating point. The voltage offset is not added. 


2.6.29 SDCTIE (SVT + 28) 


Flag word for ENABLE DCT1. See SDCTOE. 


2.6.30 SDCTI1 (SVT + 29) 


Value of ENABLE DCT1 in floating point. The voltage offset is not added. 


2.6.31 SILOE (SVT + 30) 


Flag word for ENABLE ILO. 


Bit Description 

0 never enabled or disabled 
-] disabled 

] | enabled 
2.6.32 SILO (SVT + 31) 


Value of ENABLE ILO in floating point. 
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2.6.33 _ SIHIE (SVT + 32) 


Flag word for ENABLE IHI. See SILOE. 


2.6.34 SIHI (SVT + 33) 


Value of ENABLE IHI in floating point. 


2.6.35 SVLOE (SVT + 34) 


Flag word for ENABLE VLO. See SILOE. 


2.6.36 SVLO (SVT + 35) 


Value of ENABLE VLO in floating point. The voltage offset is added to the value. 


2.6.37 SVHIE (SVT + 36) 


Flag word for ENABLE VHI. See SILOE. 


2.6.38 - SVHI (SVT + 37) 


Value of ENABLE VHI in floating point. The voltage offset is added to the value. 


2.6.39 S488CT (SVT + 38) 


Contains the control word for execution of the FACTOR 488 statements. 


Bit © Description 

23 IEEE 488 Bus SRQ interrupt pending 

22 APM high speed syne (APS) interrupt pending 
21 APM SRQ pending 


4 400 opeode active 

3 ON BRANCH active 

2 APM checked and initialized 

l APM high speed syne branching disabled (ON APS) 

0 IEEE 488 bus SRQ branching disabled (ON SRQ/ON PPR/ON APF) 


Bits 23 and 22 are set directly by their respective interrupt service routines. 
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2.6.40 SAPMCT (SVT + 39) 


APM control word for execution of APM programs. This word contains a history 
of all SRQs sent from APM. As APM requests are serviced, the corresponding 
bits in this control word are reset. Bits 0 to 15 represent the SRQ types sent © 
by APM. Bit 0 represents SRQ type 0, bit 1 SRQ 1, ete. 


23 16 0 


Data Buffers APM SRO Type — 


TTT txpxdxtxt Tp EL efx Pe bP pfx Pe Pe Px Pe 


Bit Description 


19 Data in APM error buffer 

18 Data in APM data log buffer 

17 Data in APM pass/fail test buffer 
16 Data in APM measurement result buffer 
10 APM system terminal error 

Error SRQ 

Information for data logger 
Immediate statement complete 
Abortive procedure end (APM fail) 
Normal procedure end (APM pass) 
APM at a pause 

Completed data record _ 

System operation complete 

Trigger oe 

Read data to send from data buffer 
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2.6.41 SPPM (SVT + 42) 


Reserved for Sentry VII development. 


2.6.42 SPERN (SVT + 43) 


Reserved for Sentry VII development. 


2.6.43 SPERV (SVT + 44) 


Reserved for Sentry VII development. 
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System Subroutines 


System subroutines are procedures that are available under MASTR for use by the 
operating system or user-written overlays. System subroutine definitions are 
provided unless the subroutine is reserved for system use. The reserved | 
subroutines must not be CALLed by user overlays. Using the reserved subroutines 
may leave the operating system in an undefined state. Transfer vectors used to 
aecess the system subroutines are listed in figure 3-1. 
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00640 
00641 
00642 
00643 
00644 
00645 
00646 
00647 
00650 
00651 
00652 
00653 
00654 
0065S 
00656 
00657 
00660 
00663 

00662 
00663 
00644 
00665 
09666 
00667 
00670 
00671 
00672 
00673 
00674 
00675 
004676 
00677 
00700 
00701 

00702 
00703 
00704 
00705 
00706 
00707 
00710 
00711 

00712 
N0713 
N0714 
N0715 
00716 
00717 
00720 
00721 
00722 
00723 
00724 
09725 


NON00H40 


00000640 
00002536 
00006735 
00006642 
00001726 
09001741 
90010322 
00006651 
09006666 
00006702 
00005663 
00005455 
00003276 
00017671 
00005674 
N0017A2S 
NN006345 
00006352 
00005666 
00005671 
00005669 
NN0NSTA4 
00005727 
00005732 
00005735 
90005740 
00017467 
00017514 
00017523 
00017564 
00017577 
090005425 
00005719 
00003307 
90004360 
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FLOATING POINT NOT CA NOT F => A) 
FLOATING POINT EXPONENT (A => A) 
FLOATTNG POINT MULTIPLY (A * F => A) 
FIX FLOATING POINT INTO A CA => A) 
FLOAT INTEGER IN A (A @> A) 

FLOAT NIMBFR IN A,F (A,E => A) 
FLOATING POINT COMPARF (A,E) 

LOAD A FILE INTO MEMORY 

DELETE FILE BY NAME CHANGE 

CALL OVEY FUR RELEASE 

ATTACH OVLY TO STATN 

DFTTACH OVLY FROM STATN 

PAGE TEST PLAN 

FL/RBG WAITING 

FG/RG HALT FOR MEM MOVE 

FIND VARIABLE ADDR IN STACK 
FOREGROUND IO 

START TESTER DMA AND WAIT FOR DONE 
FOREGROUND HEADER OUT 

ENARLE LOCAL MEMORY TEST 

WAIT FOR LM TEST IN FG 

DISC ADDR TRANSLATE 

CALL INTERPRETER 

ENABLE TESTER BUSY COMP INTERRUPT 
CALL OVLY FOR FG RESET 

STALL BG PROCESS 

CREATE/NELETE A FILE 

PUT ENG VALUES IN BUFFER 

PUT OCTAL/DECIMAL ADDR IN RUFFER 
CHECK IF BG ACTIVITY ON 


CALL OVLY MODULE 

PUT BINARY #4 IN BUFFER 
PUT HEX # IN BUFFER 
SAVE ENVIRONMENT 
RESTORE FNVIRONMENT 
T3US DRIVER = RESERVED 
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se | WAIT 
Reference Location 


Description | 


Input Parameters 
Output Parameters 
Return 


Calling Sequence 
Registers Used 
Allowed Usage 


3.2 OUTOPN 
Reference Location 


Description 


Input Parameters 


Output Parameter 


Return 
Calling Sequence 


Routine Used 
Registers Used 


Allowed Usage 


SYXVEC + 0 


This is a wait routine called by the foreground 
processing when the test station becomes busy. It 
allows background processing to continue. 


Control returns to foreground only after the contents 
of address AWATF (GLOVAR + 79) are set to 1 

by the interrupt service when the busy condition 

is completed. 


None 


None 


BSM address +1 


_ BSM* — WAIT 


All registers and state switches are saved and 
restored. | | 


| ‘Foreground only 


SYXVEC + 1 


This subroutine opens an output device for a string 
record file. It can be used to output data summary. 


CMDV (GLOVAR +49) must contain the device eode. 
If CMDV is zero, the system POD is used. 


NAMEM1, NAMEM2 (GLOVAR +50, 51) must contain 
the file name if the device is a CLO or DOF. 


X6 contains the pointer to IOATAB for this device. 
BSM address +1 error return 

BSM address +2 normal return 

BSM* OUTOPN 

$IOCS 

X1, X6, A, and E are not restored. 


Background only 


3-4 


3.3 OUTCLS 
Reference Location 
Description 

Input Parameter 
Output Parameters 


Return 


Calling Sequence 


Routine Used 
Registers Used 


Allowed Usage 


3.4 NUMERR 
Reference Location 
Description 

Input Parameters 


Output Parameters 


Return 


Calling Sequence 


Routine Used 


Registers Used 


SYXVEC +2 

This subroutine closes an output device. 
X6 pointer to IOATAB. 

None 


BSM address +] 
BSM address +2 


error return 
normal return 


LDX* X6,IOATAB ptr. 
BSM* OUTCLS 
$1IOCS 


X1, A, E and X6 are not restored. 


Background only 


SYXVEC + 3 

This handles number errors for all programs and 
subroutines. Because of its general nature, error 
reporting is at a minimum. 

None 

None 

Control is not returned to the caller. An error mes- 
sage, ERROR IN NUMB, is output to POD by the moni- 


tor, and control is passed to the monitor command 
sean routine. 


BRU* NUMERR 


MSGOUT to print out the error message by the 
monitor. 


Not applicable sinee there is no return to caller. 


Note 


If the user intends to conduct any kind of recovery 
from a number error (for example, requesting a number 
again from an input device), this routine should not 

be used. Instead, BRU to another routine in the 

user's program for recovery. 


Allowed Usage 


“320 COMERR 
Reference Location 


Description 


Input Parameter 
Output Parameters 


Return 


Calling Sequence 


Routine Used 


Registers Used 


Background only 


SYXVEC + 4 

Processes a command decoding error (decoding done 
in the subroutine called PROCESS) for all 

programs and subroutines. Because of its general 
nature, error reporting is at a minimum. 

E contains one-word text of error. 


None 


Control is not returned to the caller, an error mes- 


sage, ERROR IN XXXX, is output to POD by the moni- 
tor, and control is passed onto the monitor command 
sean routine. XXXX is the contents of E on entry. | 


BRU* COMERR 
MSGOUT prints out the error message by the monitor. . 


Nonessential to the ealler, as this is an error 
terminating subroutine. 


Note 


If the user intends to conduct any kind of recovery from 
a command error on further diagnosing the error, this 
subroutine should not be used. Instead, BRU to user's 
own error handling routine for this error processing. 


Allowed Usage 


Background only 


3.6 $1OCS 
Reference Location 


Deseription 


3.7 MSGIN 
Reference Location 
Deseription 


Input Parameters 


Output Parameter 


Return 


Calling Sequence 


INBUF 


Registers Used 


Allowed Usage 


3.8 MSGOUT 


Reference Location 
- Description 


Input Parameters 


Output Parameter 


Return 


SYXVEC + 5 


See section 4 


SYXVEC +6 

Reads a record from the system PID. 

Xi Starting address of input buffer (buffer must 
have 18 words) : 

A Prompting character in TRASCII right 
justified or zero 


A $IOCS error code for error return 


BSM address +] error return 
BSM address +2 normal return 


BSS 18 
LDX X1,INBUF 
LDA DO or CLA 


BSM* MSGIN 
BRU ERROR 


-- normal return 


A, E, X1, and X6 are not restored. 


Foreground/background 


SYXVEC +7 
Writes a record to the system VKT. 


X1 Starting address or record buffer 
X2 Number of words to be output 


A $IOCS error code for error return 


BSM address +1 error return 
BSM address +2 normal return 


Calling Sequence 


OUTDCB 
OUTBUF 


Registers Used 


Allowed Usage 


3.9 UMSGW 


Referenee Location 


Description 
Input Parameters 


Output Parameter 


Return 


Calling Sequence 


OUTBUF 


Registers Used 


Allowed Usage 


DATA 0,OUTBUF,5 
TEXT 'XXXXXX WORDS LEFT’ 


LDX x? ; 5 sp Mu mkhew ¢ gE : ee an a ee ee 
BSM* MSGOUT 
BRU ERROR 

| error return 
-- normal return 


A, E, Xl, and X6 are not restored. 


Foreground /background 


- SYXVEC + 8 


Writes a record without carriage return and line-feed 
to system POD. 


X1 Starting address of record buffer 
X2 Number of words to be output 


A $1OCS error eode for error return 


BSM address +1 error return 
BSM address +2 normal return 


TEXT "PIN =! 


LDX X2,5 
LDX X1,OUTBUF 
BSM* UMSGW 


BRU ERROR. 
-- normal return 


A, E, X1, and X6 are not restored. 


_ Foreground/background 


3.10 ADJMEM 
Reference Location 


Description 


Input Parameters 


Output Parameters 


Return 


SYXVEC + 9 


This routine handles adjustment of dynamie memory 
allocation area. Its functions are releasing a file by 
name, or releasing all test programs or all overlays; 
expanding a test program or overlay, or repacking a 
test program or overlay. Physically, the data in the 
impacted memory area is moved up or down and the 
memory activity table is updated for the change. 


BSM address + 1 


- Function code to be performed 


Release a file specified in X5 

Release all test programs 

Release all overlays 

Release all test program overlays 

Expand the test program or overlay 

specified in X5 

5 Repack the test program or overlay 
specified in X5 

6 Bump page TP or release inactive 
programs 

7 Release all modules 

8 Release all files previously marked for release 

9 Make room for fixed overlay 


im OF DO = © 


For funetions 0, 4 and 5, X5 must contain the address 
of the file entry in MACTAB. 


For function 4, the A register must contain the expan- 
sion size in words. 


For function 5, the A register must contain the new 


test program or overlay size in words, 


For functions 6 and 9, the A register must contain the 
required size in words. 


For funetion 9, X5 points to MACTAB entry. 


For functions 4, 5, 6, and 9, BSM address + 2 cannot 
expand due to lack of memory space. 


BSM address + 3 for expansion complete 
BSM address + 2 for all others 


Calling Sequence 


For funetions 0, 1, 2 and 3 


LDX X1,funetion code 
BSM* ADJMEM 
DATA 0/1/2/3 | 

| | normal return 


For funetions 4 and 5 


-LDX  X5,MACTAB address 


LDA SiZe _ 
BSM* | ADJMEM 
DATA 4/5 


ae | | error return 


ne , a normal return 


For functions 6 and 9 


Routines Used | 


Registers Used 


Allowed Usage 


Pe i SCNFIL 
Reference Location 


Description 


DATA 6/9 


LDA size 
BSM* ADJMEM. 
Ss - 4 error return 

= | normal return 


MOVEDN __ to paek the memory 

MOVEUP __ to expand the memory 

FGBGH to wait for foreground or background 
3 3 activity completion 


A and E registers are not restored. 


Background only. Foreground may call this routine on 
special condition, but this feature is reserved for the 
operating system. 


SYXVEC +10. 


This routine seans MACTAB to find the requested file, 


_ or output test program or overlay names on POD. 


The function performed depends on the code supplied 


in X1 register. 


Input Parameters 


Output Parameters 


Return 


Calling Sequence 


Xl Function code 


0 Search for any file with the name in A and E 
] Search for a test program with the name 
in A and E 
2 Search for an overlay with the name in A and E 
3 Search for a system job overlay with overlay 
eode inA | 


4 List all test programs in memory 

D List all overlays in memory 

6 List all files in memory 

7 List one file with X5 pointing to MACTAB 
8 LIST JOB 


For functions 0, 1 and 2, A and E registers must con- 
tain maximum six-character file name left justified. 


For function 3, the overlay code (13 to 40B) must be in 
A register. | 


For functions 0, 1, 2, and 3, the BSM address +1 must 


contain the job name. (If zero, the current job is 
used). 


For function 7, X5 must point to the file entry in 
MACTAB. 


For functions 0, 1, 2, and 3 upon normal return: 


X5 address of the file entry in MACTAB : 
X7 starting address of the file in memory 


None for all other functions 
For functions 0, 1, 2, and 3: 
BSM address +2 not found return 


BSM address +3 normal return 


For all others: 
BSM address +] 


For functions 0, 1, 2, and 3 


JOB 


Routines Used 


LDX X1,funetion code 

BSM* SCNFIL | 

DATA 0 Job number 
BRU ERROR not found return 


-- found return 


$1O0CS_ to output names for functions 7, 
4, 5, and6 
PUTD to place values in output buffer 


Registers Used 


Allowed Usage 


3.12 GTSTAT 
Reference Location 


Description 


Input Parameters 


Output Parameters 


Return 


Calling Sequence 


Registers Used 


Allowed Usage 


BSM address +] 


A and E are not restored for functions 0, 1, 2, and 3. 
No register is restored for functions 4, 5, 6, and 7. 


Functions 0, 1, 2, and 3 are allowed for foreground and 
background. 


Functions 4, 5, 6, and 7 are allowed for background 
only. 


SYXVEC + 11 


This subroutine decodes the station identification 
entered in an operator command into internal usage 
format. 


STATC (GLOVAR +66) Station identification 1 
through 4 which is normally set by the PROCESS rou- 


tine. If STATC = 0, then DFSTAT (GLOVAR +88) is 


used as default station. 


A and X6_ Logical station number (0 through 3) 
X2 - S§tarting address of tester variable table, VKT 
for that station. On error return, E= 'STAT'. 


station ID not entered in command or 
no default has been set up by SET 
STAT command. 

BSM address +2 normal return 


BSM* GTSTAT 


BRU ERROR NO STATION RETURN 


normal return 
A, E, X2, and X6 are not restored. 


Foreground/background 


3.13 CONV 
Reference Location 


Description 


Input Parameters 


Output Parameters 


Return 


Calling Sequence 


Registers Used 


Allowed Usage 


SYXVEC + 12 


This subroutine is used to convert a positive 

number in A register into its decimal equivalent. 

The decimal digit is represented in a certain number of 
bits specified by the caller (the digit width). The digit 
width is specified in the E register. 


For example, before calling the subroutine, 

A = 144 (octal) 

E = 4 [i.e., 4 bits for each decimal digit (BCD)] 
Upon exiting from CONV, 

A=0 

but, 

E= 


== 
One Decimal Digit 


10 0 (BCD) 


A positive octal number 
E digit width in bits 


A 0 | 
E converted number in decimal representation 


BSM address + 1] 


LDA OCTNUM 
LDE DIGWID 


~BSM* CONV 


A, E, and Xl 


Foreground/background 


a | PUTD 
Reference Location SYXVEC + 13 


Description This subroutine converts a positive number in the 
A register into its TRASCII coded decimal equivalent and 
packs it into a user-specified buffer. 


Input Parameters A positive number to be converted and packed 
X1 number of digits wanted (field width) 
(Each digit is represented by a 
TRASCII coded character). 
X7 pointer to the three-word DCB 


word 0 character count 
word 1 buffer address 
word 2 buffer size in words 
State switch 7 set do not suppress leading zeros 
State switch 7 not set suppress leading zeros 
Output Parameters A pointer to the next available location in the PMF 
buffer. 


If the number overflows its field (larger than the field 
width specified), a back slash is stored into the 
buffer before an exit of the routine. 


Word 0 of the DCB points to the next available char- 
acter in the buffer. | : 


~ Return BSM address + 1 


Calling Sequence | 


LDX X1,3 
LDA NUMBER 
LDX X7,PMFDCB 
BSM* PUTD 
Routine Used PUTC 
Register Used X1 is not restored. 
Allowed Usage Foreground/baeckground 


3.15 PUTC 
Reference Location 


Deseription 


Input Parameters 


Output Parameters 


Return 


Calling Sequence 


Register Used 


Allowed Usage 


SYXVEC + 14 


This subroutine is used to pack a character in the 
lower six bits in A register into the buffer specified 
by the caller in X7. 


A a TRASCII character in the lower six bits 
X7 pointer to a three-word DCB 


word 0 character count 

word 1] buffer address 

word 2 buffer size in words 
A 0 | 


0, X7 incremented to next character location in buffer 


BSM address +1 0, X7 beyond buffer size 
BSM address +2 normal return 


LDA TRASCII 

LDX X7,PMFDCB 

BSM* PUTC 

== error return 
_— normal return 


A is not restored. 


Foreground/background 


3.16 MOVEDN 
Referenee Location 


Description 


Input Parameters 


Output Parameter 
Return 


Calling Sequence 


Registers Used 


Allowed Usage 


SYXVEC + 15 


This subroutine moves data blocks from one 

memory location to another. Data is moved from a 
block in ascending order, or from a smaller to a larger 
address in the block. 


X5 Smaller X7/ 
| address 
Data pickup Data flow 
flows from from block 


top to bottom to block 


Larger 
: a address 
Block to be moved Block to move to 


x4 


X5 starting address of block to be moved 
X4 ending address of block to be moved 
X7 starting address of block to move into 
X7 last word moved address + 1 


BSM address + 1] 


LDX — X5,BLKTOP 
LDX X4,BLKBOT 
LDX X7,INTOP 


BSM* |= MOVEDN 
X4, 5, and 7 


Foreground /background 


3.17 MOVEUP 
Reference Location 


Description 


Input Parameters 


Output Parameters 
Return 


Calling Sequence 


Registers Used 


Allowed Usage 


SYXVEC + 16 


This subroutine moves data blocks from one 
memory location to another. Data is moved from a 
block in descending order, or from a larger to a 
smaller address in the block. 


x4 Smaller 
Address 
Data pickup 
flows from Data flow 
bottom to top from block 
to block 
—_———_—_—_ > 
Larger 
Xx5 Address 


Block to be moved Block to move into 


X4 ending address of block to be moved 
X5 starting address of block to be moved 
X7 starting address of block to move into 


None 


BSM address + 1] 


LDX X5,BLKBOT 
LDX X4,BLKTOP 
.LDX X7,INTOP 


BSM* MOVEUP — 
X4, 5, and 7 


-Foreground/background 


X7 


3.18 PUTE 
Reference Location 


Description 


Input Parameters 


Output Parameters 


Return 


Calling Sequence 


Routines Used 
Registers Used 


Allowed Usage 


3.19 PUTO 
Reference Location 


Description 


Input Parameters 


SYSVEC + 17 


This subroutine converts a floating point number to 
printing format, a four-digit integer, or scientific 
format and places it in the buffer. 


A a floating point number 
X7 starting address of three-word DCB 
(used by PUTC, PUTD) 


_Converted number in the buffer. If the floating point 


number is an integer and the magnitude is between 
-999 and +9999, the format is -nnn to nnnn. 


For all other numbers, the format is tn.nnnEtnn. The 
decimal point moves left or right in order to make 

the characteristie a multiple of three. 

0 and X7 are adjusted to one character beyond the last 
used. The output requires 10 columns. If an integer 

is output the remaining spaces are cleared. 


BSM address + 1 


LDA NUMBER 

LDX X7,DCB 

BSM* PUTE 

PUTD, PUTC, CONV, FFIXS 
A, E, X1, SW7 are not restored. 


Foreground/background 


SYXVEC +18 


This subroutine converts a binary number into octal 
TRASCII and places it in the buffer, right justified. 


A positive binary number 
X1 number of digits desired 
X7 PMF pointer 


State switch 7 set 


State switch 7 not set suppress leading zeros 


do not suppress leading zeros 


Output Parameters 


Return 
Calling Sequence 


DCB 
BUF 


Routine Used 
Registers Used 


Allowed Usage 


3.20 PROCESS 
Reference Location 


Description 


0 and X7 are adjusted to point to the next character 
position 


BSM address +1 


DATA 0, BUF, 20 


BSS 20 
LDA NUMBER 

LDX X1,8 8 digits 
LDX X7,DCB 


BSM* PUTO 


A and X]1 are not restored 


Foreground/baekground 


SYXVEC + 19 


This subroutine is used to sean a command statement 
(represented in a string record) to create a coded 24- 
bit word representation of the statement. A statement 
is made up of various fields separated by spaces or 
other special characters. The codes are supplied by © 
the caller in his keyword table which contains 
identifiers and corresponding codes for all identifiers 
in the command statement to be decoded. 


PROCESS seans the statement fields, using the table 

to select the code corresponding to matching identifiers or 
special options and builds the coded representation from the 
codes, 


The fields of a statement are identified as one of the 
following: | 


e Identifier - Starts with an alpha character and up 
to four alphanumeric characters. 

@ Name - A string of up to six characters, enclosed 
by single quotes ('). Quotation marks are not 
counted as part of the six character name. 


@ Number - A field with only numeric characters 
(tnnn), numeric characters with a decimal point 
(+nn. n), numeric characters followed by B to 
specify an octal number, numeric characters with 
exponential notation (+nnE+n), numeric charac- 
ters followed by * to specify a binary number. 

e Identifier Number - Identifier up to four characters 
is matched with a number (FRQnn). There is no 
space or special character between the identifier 
and the number. 

e Special Character - A comma (,) is considered as a 
special option identifier. 


Input Parameters X5 The address of three-word DCB 
word 0 Current word/character count 
word 1 Buffer address word 
word 2 Buffer size 
X7 Starting address of the key word table 
X6 Ending address (last word of the table +1) 


Rules and Restriction of Input: 


1. Each entry in the key word table must be two words. 


Word 1 four character identifier 
Word 2 code for the identifier 
Word 2 format 

18 17 16 15 


Bit 23 Key word flag 
Bit 22 to 18 Key code 


All identifiers that PELOne to the key word contain the same code as the key 
word. 


Bit 17 Complete flag 
This flag provides the capability to require a modifier. The statement is 


complete only if this bit is set. It is set in the code of the key word if no 
modifier is required; otherwise, it is set in the code of a required option. 


3-20 


At least one identifier must set this bit or PROCESS takes the error return. 
For example, if either ON or OFF must be specified, the bit is off in the key 
word code and set in the eodes for ON and OFF. 


Bit 16 Duplicate flag 


This flag provides the capability to disallow the use of two or more options 
together. If this bit is set by a modifier that is in a statement, PROCESS 
takes the error return if another modifier is seanned that also has this bit 
set. For example, to cause an error if both OFF and ON are entered in a 
statement, set the duplicate bit in the codes for OFF and ON. 


Bits 14 to 0 Options 

These bits are defined by the user to identify the optional identifiers 
By checking these bits the user can determine which modifiers were 
entered. 


Bit 15 Identifier number concatenated from flag (see 6 below). 


The first field in the statement must be a key word. Any other occur- 
rences of key words are ignored. | 


A maximum of two number fields in a statement are saved. 

A maximum of two string names in a statement are saved. 

A maximum of six identifier-number fields are allowed in a statement. 
Codes provided for the identifiers that appear in a statement in the 
identifier-number form must be a value in the range | to 6 in bits 5 to 0 and 
bit 15 is set to 1. These may not be key words and the value is not ORed 
into the final code. The value 1-6 is used to store the associated number. 


Bits 23 to 18 should conform to the key code. 


No more than three input device and three output device mnemonics may 
appear in a statement. , 


Normally, noise words are not allowed in a command. ECHFLG (GLOVAR 
+ 40) is used to control this condition. 


If the STATn. is allowed in the command, it must be entered in the table 


with the code, XX100000B; -f universal, XX is zero; otherwise, XX should 
eonform to the key code. 
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10, Only one binary number is saved. 


Output Parameters 


Description of Output: 


A Final eoded representation of the statement upon 
error return 


E_ The graphics of the error 


"PARM' Invalid pen mmeter usage 
"COMM 'Duplicate key word or missing parameters 
"NUMB' Number error 

-X5 MACTAB pointer if an overlay is loaded. 

X?7 Start address of file if overlays are loaded 


1. The final code is formed by ORing the codes of identifiers appeared in the 
statement except identifier-number codes. 


Final code format: 


23 18 17 16 15 


ik] Rey cove Jefofs| atom cate | 


Bit 


23 
22 to 18 


14 to 0 


Description 


Key word flag (from the identifier in the first field) 
From the key identifier and subset of key identifier, 
if any 

Complete statement 

Duplicate flag 

One or more string names have appeared in the 


statement. The first four characters of the first name 


are stored in NAMEMI global and the last two charac- 
ters in NAMEM2 global. The second name is stored in 
NAMEM3 and NAMEM4. Only the first six characters 
of each name are saved. | 
Codes provided for optional identifiers are ORed 
together 


ee) 
} 

be 

bd 


If one or more numbers have appeared in the statement, decimal values are 
saved in NUMB1 and NUMB2 in floating point format in the order entered 
(twos complement if negative). Numbers are also saved in ONUMBI1, ONUMB2 
in octal form. Fixed decimal representations of numbers are saved in INUMBI, 
INUMB2. If a digit 8 or 9 has appeared in a number field, global OFLERR 

is set to 1. NUMB1, NUMB2, INUMBI1, INUMB2, ONUMBI1, ONUMB2 and 
BINARY are initialized to -1. A binary number is saved in BINARY with 

its digit count in BINCNT. 


Examples: 
Input INUMB1 INUMB2 ONUMBI ONUMB2 OFLERR 
0101* 5 -] 101 -] 0 
101 145B =] 101 -] 0 
101B 101B -] 101 -] 0 
81 121B -] 101 ~] l 
10B 10 10B 12B 10 10 0 
20 0101* 24B 5B 20 101 0 
0101* 20 5B 24B 101 20 0 
Input BINARY BINCNT NUMBI NUMB2 
0101* 5 4 20720000B (FP5) -] 
101 -] 0 21745000B (FP101) -] 
101B -] 0 21701000B (FP101B) -] 
81 -] 0 21721000B (FP81) -] 
10B 10 -] 0 21100000B (FP8) 21120000B (FP10) 
20 0101* 5 4 21320000B (FP20) -20720000B (FP5) 
0101* 20 5 4 20720000B (FP5) 21320000B (FP20) 


If one or more identifier-number fields have appeared in the statement, num- 
bers are stored in globals SPNUM1 through SPNUM6 according to the eode 
provided for the identifier. SPNUM1 through SPNUM6 are -1 if no identifier 
number is entered. | | 
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4. If I/O device mnemonics appear in the statement, then a pre-defined 
device code is stored for each device mnemonic in the same order as 
they appear in the statement stored in global CMDV. The device codes 
are in the following format: 


23 20 16 12 8 4 0 


Output 3 | Input 3 Output 2 Input 2 | Output 1 Input 1 


Code ___ Input Output 
] TTK ‘DLP 

2 MTR1 MTW1 
3 MTR2 MTW2 
4 CR LP 

9) DIF DOF 

6 CLI CLO 

7 VK2 VP2 

8 MIF MOF 


5. If a STATn appears in the statement, the station identification number 
is stored in global STATC in binary, (STATI then STATC = binary 1. STATC 
is initialized to -1). 


6. If a comma appears, bit 14 of SPOPT is set to 1. If a plus sign appears, 
bit 1 is set to 1. If a minus sign has appears, bit 0 issettol. | 


Return BSM address +l error return with E = error code 
BSM address +2 normal return with A = final code 


Calling Sequence 


LDX X95, DCB addr 

LDX X7, table start addr 
LDX X6,table end addr 
BSM* PROCESS 


BRU ERROR error return . 
-- normal return 
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Example: 


TABSTR 


TABEND 


PMFDCB 


BUF 


Result: 


Command Entered 


COPY 

COPY ALL 
COPY OFF 
COPY ALL 


EQU 
DATA 
DATA 
DATA 
DATA 
EQU 


DATA 
DATA 
DATA 
BSS 


LDX 
LDX 
LDX 
BSM* 
BRU 
STA 


FRQ6 


* 


'COPY', 41400000B 
'ALL', 01000100B 
'OFF', 01000200B 
'FRQ', 01100001B 


X5,PMFDCB 
X6,TABEND 
X7,TABSTR 
PROCESS 
ERROR 
COMING 


Code Formed 


41400000B 
41400100B 
41400200B 


41400100B 


KEY IDENTIFIER 
SUB-OPTION IDENTIFIER 
SUB-OPTION IDENTIFIER 
IDENT-NUMBER FIELD 


CURRENT WORD COUNT 
BUFFER ADDRESS 
BUFFER SIZE 


SAVE A AT NORMAL RETURN 


SPNUMI1 = 6 


3.21 ALTER 
Reference Location SYXVEC + 20 


Description — This routine scans the ALTER buffer to elear all 
| entries for a station, replace or make new entry, find 
a particular entry, and list all entries for a station. 


Input Parameters | BSM address +1 contains option number 
Option number 


0 Clear all entries for a station and pack 

1 Replace if an entry for the instruction exists; 
otherwise, make a new entry 

Find an entry for the instruction 

List all entries for a station 

Clear one entry for the instruction 


H © bo 


A Station number in bits 20 through 18 right 
justified for options 0 and 3 


Station number in bits 20 through 18 IND value 
in bits 17 through 0 for options 1, 2 and 4 


23 21 18 0) 


Stat | IND Value/O 


STAT 0= STATI 
1 = STAT2 


E Floating point value for option 1 
A Floating point value for option 2 
None for all other options 


Output Parameters 


Return BSM address +3 normal return 
BSM address +2 not found for option 2 
alter buffer full for option 1 


Routines Used $PARSE, GETC, IDTSCN, SEARCH 


Registers Used X1, X5, X6, X7, A, and E registers 
X1 is restored 


Allowed usage 


Routines Used 


Calling Sequence 


System use only 


PUTE, PUTC, $IOCS for option 3 only 


Options 0 and 3 


Option 1 


Option 2 


Registers Used 


Allowed Usage 


station number 


station number 
18 
IND value 


floating pt. val. 


ALTER 
] 
ERROR 


station number 
18 

IND value 
ALTER 

—_ 


OVERFLOW 
normal return 


NO ALTER VALUE 
YES ALTER HERE 


A, X6, and E are not restored for options 0, 1, 2 and 4. 


A, E, X1, X2, X3, X6 and X7 are not used and not 
restored for option 3. 


Options 0, 1, 2 and 4 are allowed for foreground 
and background for system use only. 


Option 3 is allowed for background for system use 


only. 


3.22 $PARSE 
Reference Location §  SYXVEC +21 


Description This subroutine is used to sean and identify a 
field in the caller's buffer as follows: 


1. Identifier - a string of alphanumeric charac- 
ters with an alpha leading character. It is terminated 
by either a maximum of eight characters or 
by a special character (a space is treated as 
a special character). It is packed (left justified) 
into two global variables NAMEI1 and NAME2. 
' However, upon exiting from this subroutine, 
X6 contains the location of NAME] in memory. 


2. Number - a string of numeric characters 
(TRASCII coded) is converted into a floating point 
number and stored in the E register upon exiting 
from this subroutine. When a ''sign is encountered, 
a 15B is returned in A. The caller must make 
provision for this in processing negative numbers. 


3. Special character - If the character is other 
than a space or a period, which are 0B and 16B 
respectively in TRASCII code, it is stored in 
the A register before exiting from this subroutine. 
A space is ignored when seanning for the start 
of a field, but also terminates the field when 
processing it. A period is taken as a decimal 
point when processing a number field. 


Input Parameters XT address of the three-word DCB 
2 a word 1 character count 
word 2 buffer address 
word 3 buffer size in words 
Output Parameters The A register can be one of the following codes: 
1. 0 error in a number sean. 


2. 1lthru77B the TRASCII code of a special 
character encountered 


3. 100B an identifier is encountered 
and packed into NAMEI and 
NAME2 
X6 location of NAMEI in memory 
4. l101B a number is encountered and 


eonverted into a floating point 
equivalent (stored in E register) 
and an octal equivalent (stored in 
| OCTAL i.e. 10=8]9). 
a» LIB end of record - end of buffer 
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Return 


Calling Sequence 


Routines Used 
Registers Used 


Allowed Usage 


3.23 IDTSCN 
Reference Location 


Description 


BSM address + 1 


LDX X7,PMFDCB 
BSM*  $PARSE > 


GETC, IDTSCN, NUMBER 
A, E, X6 are not restored. 


Background only. 


SYXVEC + 22 


This subroutine is used to sean the caller's buffer for 
an identifier or a string field and packs it (left 
justified) into global variables NAMEI and NAME2. 


Prerequisites: 


1. The caller must have located the first char- 
acter of either an identifier or a string field. 


2. The ealler should distinguish between packing 
an identifier (setting the OV, overflow indicator) 
or a string input (resetting the OV). | 


Explanation: 


When this subroutine is packing a string input, the 
subroutine checks for whichever of the following ter- 
minators comes first: 


® aprime mark -' 

e an end-of-record mark -177B 

@e exceeds eight characters in the string, at 
which time the subroutine continues seanning the 
buffer for either of the above, but there is no more 
packing into NAME] and NAME2. 


When this subroutine is packing an identifier, the 
subroutine stops scanning when it detects any special 
character. 


In all cases, only the first eight characters maximum 
are packed (left justified) into NAME] and NAME2. 
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Input Parameters OV set for identifier sean © 
reset for string scan 
A first character 
X7 pointer to three-word D 


Output Parameters X6 address of NAMEI in memory. 
The globals NAME] and NAME2 contain eight 
characters of the name. 


Return BSM address +1 


Calling Sequence 


LDA ~= CHARS 
LDX X7,PMFDCB 
SST OV for identifier sean 
BSM* IDTSCN 
LDA CHARS 
LDX X7,PMFDCB 
RST OV for string sean 
BSM* IDTSCN 
Routine Used GETC 
Registers Used . A, E, X7, and X6 
Allowed Usage Background only 
3.24 NUMBER 
Reference Location SYXVEC + 23 
Deseription — This subroutine Seans a number in one of the following 


forms in the input buffer: 


1. Octal integer nnn, nnnB 

2. Decimal number nn.nn, nn 

3. Exponential number ~ nnE+tnn 

4. Binary number | nnnnnnnnnn* 
Input Parameter | X7 starting address of the PMF control 


block 0, X7 must contain the character 
pointer pointing to the beginning of the 
number field (the most significant digit 


or - sign). 
Output Parameters A=0 number syntax error 
| A = 100B number has been converted 
E | number in floating point 


OFLERR (GLOVAR + 46) = non-zero if a digit 
8 or 9 has appeared in the field 

OCTAL (GLOVAR + 45) contains octal repre- 
sentation of the number 
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Return 


Calling Sequence 


Routines Used 
Registers Used 


Allowed Usage 


3.25 INTSCN 
Reference Location 


Description 


Input Parameters 


Output Parameters 


Return 


0, X7 is updated to point to the next character 
(number terminating character) 
BINC (GLOVAR + 52) contains binary representation 


of the number 


BINCNT (GLOVAR +53) contains the number 
of digits appeared in the representation 
of the number 

MANTISSA (GLOVAR +48) contains fixed decimal 


form of the number 


BSM address + 1] 


LDX X7,PMFDCB 
BSM* | NUMBER 


GETC, INTSCN 
A, E, X6 are not restored 


Background only 


SYXVEC + 24 


This subroutine is used to sean the number field in the 


buffer for an integer and to convert it into an octal . 


number and a decimal number. The two conversions 
are done simultaneously and both values are available 
to the caller upon exiting from this subroutine. 


X7 pointer to three-word DCB 
X6 pointer to the location which is to store the 
result of the decimal conversion 


A last character obtained from the buffer (the 
first non-numeric character obtained in the 
seanning of the number) 


E digit count of the number obtained 

X6 pointer to the location containing the 
decimal equivalent 

0,X7 has been updated just past the number 
field 

OCTAL (global variable) contains the octal 
equivalent 


BSM address + I 


Calling Sequence 


Routine Used 
Registers Used 


Allowed Usage 


3.26 SEARCH 
Reference Location 


Description 


Input Parameters 


Output Parameter 


Return 


Calling Sequence 


TABSTR 


TABEND 
ITMSIZ 


Registers Used 


LDA X7,PMFDCB 
LDX X6, DECNUM 
BSM*  INTSCN 


GETC. 


A, E, X6 are not restored 


Background only 


SYXVEC + 25 


This subroutine is used to search through a table 
Supplied by the caller for a name specified in 

NAME] and NAME2. NAMEI and NAME2 are normally 
set up by the $PARSE subroutine before this subroutine 
is called. | 


X6 ending address +1 of the table to be searched 

X7 starting address of the table to be searched 

A number of words per entry in the table supplied. 
It is used as a bias to step through the table 
from item to item. The minimum value is two. 


X7 address of the item found in the table. 


BSM address + 1 item found in table 
BSM address + 2. item not found in table 


LDX X6, TABEND 
LDX X7,TABSTR 
LDA ITMSIZ 


BSM* SEARCH 


EQU x 
BSS 200B 
EQU O* 
EQU 4B 


X6, X7, A, E are not restored 


3-32 


Indicator Used 


Allowed Usage 


3.27 MPZERO 
Reference Location 


Description 


Input Parameters 


Output Parameter 
Return 


Calling Sequence 


BUFSTR 
BUFEND 
Registers Used 


Allowed Usage 


3.28 GETC 
Reference Location 


Description 


OV (overflow) is undefined on return. 


Foreground /background 


SYXVEC + 26 


This subroutine is used to clear memory (move 
zeros into memory locations) within specified 
limits. 


X6 ending address of the memory to be cleared 
(the larger of the limits). 

X7 starting address of the memory to be 
cleared (the smaller of the limits). 

A=0 


BSM address + 1 


LDX X6,BUFEND 

LDX X7,BUFSTR 

BSM* MPZERO for external 
programs/subroutines (indirect 
calling through system trans- 
fer vector) — 

EQU 

BSS 200B 

EQU t=] 


X6, X7, A, E are not restored 


Foreground /baeckground 


SYXVEC + 27 


This subroutine gets a character from the buffer 
specified by the caller and decodes it into one 
of the following: 


@e alpha 


@® numeric 
@ special character 
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Input Parameters _ X7 pointer to three-word DCB 
word 1] character count 
word 2 buffer address 
word 3 buffer size in words 


Output Parameters A character from buffer 


Return BSM address + 1 eharacter is alpha 
BSM address + 2 character is numeric 
BSM address + 3 character is special, including 
the 177B (end of buffer) 


Note that $, the dollar sign, is regarded as an alpha 
character. The character returned is in TRASCII 
-eode (right justified). 


Calling Sequence 


LDX X7,PMFDCB 
BSM* GETC 
Routine Used READW 
Register Used A 
Allowed Usage Foreground /background 
3.29 READW 
Reference Location SYXVEC + 28 
Description This subroutine is used to read a word from the 


specified buffer in memory. 


Input Parameters X7 pointer three-word DCB 


word 0 ~ character count 
word 1] buffer address 
word 2 buffer size in words 


A relative address of the word in the buffer 
Output Parameters A the eontent of the word (if the location 
of the word is still within the buffer limit) 
X7 unchanged 


Return BSM address +1 if location of word is out of bounds 
BSM address +2. if still in bounds 
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Calling Sequence 


LDX X7,PMFDCB 
LDA 0,X7 get character count 
SR 2 get the relative word address 
BSM* READW 

Register Used A is not restored. 

Allowed Usage Foreground/background 

3.30 WRITEW 

Reference Location SYXVEC + 29 

Description This subroutine is used to write a value from 
the E register into a caller-specified buffer in 
memory. 

Input Parameters X7 pointer to the three-word DCB 


A relative address of the word in the 
buffer to receive the value 
Evalue to be written into the buffer 


Output Parameters X7 = A_ absolute address of the location in the 
buffer that was just written into (if it 
does not exceed the boundary of the 
buffer itself) 


Return BSM address +1, if write out of bounds 
BSM address + 2, if write within bounds 


Calling Sequence 


LDX X7,PMFDCB 

LDA 0,X7 get character count 

SR 2 get relative address of word 
LDE VALUE 


BSM * WRITEW 

-- error return 

-- normal return 
Register Used A is not restored. 


Allowed Usage Foreground /baeckground 
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3.01 IERMSG 
Reference Location 


Description 


Input Parameter 
Output Parameters 


Return 


Calling Sequence 


Registers Used 


Allowed Usage 


3.32 DUMP 
Reference Location 


Description 


Input Parameters 


Output Parameters 


Return 


Routine Used 


SYXVEC + 30 


Routine in test head driver (THD) to handle terminal 


_ errors 


A terminal error number 
None 


No return. THD completes testing and continues 
to next station 


LDA TENUM terminal number 
BSM* IERMSG | 


Not applicable 


Foreground only 


SYXVEC + 31 


This routine dumps an overlay, a test plan, or a module © 
to a storage medium, magnetic tape, disk or Integrator. 
The file to be dumped must be in memory. 


X5 points to MACTAB 


CMDV (bits 7 to 4) contains the output device code. 
If these bits are zero, the DFDV device is used. 


A error code for error return 
A If positive, IOCS error code 
A If negative, PARM if illegal device 
NAME if the file is partial or not in memory 


BSM address + 1. error return 
BSM address + 2 normal return 


$10CS 


Calling Sequence 


BSM * DUMP 
-- error return 
-- normal return 


Registers Used A, E, X1, X6 are not restored. 

Allowed Usage Background only 

3.33 PUTIME 

Reference Location SYXVEC + 32 

Description This routine converts the current time into HH:MM 


format and places it in the buffer following the date. 


Input Parameters DATE (GLOVAR + 29, 30) contains the current date 
TIME (GLOVAR + 31) contains the current time 
in seconds 


X7 starting address of three-word DCB (used 
by PUTD, PUTC) 


Output Parameters Date and time are placed in the buffer 
Format: 
MM/DD/YY HH:MM 
where MM/DD/YY is an eight-character date entered 
by the command: DATE. It is output in the format 
entered in the command. 
HH hours in 01 through 23 
MM _ minutes in 00 through 59 
YY 2 spaces | 
0, X7 is adjusted to one character beyond the last used. 


Return BSM address + 1 


Calling Sequence 


LDX X7,DCB 
BSM * PUTIME 
Routine Used PUTD, PUTC 
Registers Used A, E, X1 are not restored. 
- Allowed Usage Foreground/background 
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3.34 GTTDV 
Reference Loeation | 


Deseription 


Input Parameters 


Output Parameters 


Return 


Calling Sequence 


SYXVEC + 33 

This subroutine calculates the address of the device 
entry in TVT table for the station and obtains the 
IOATAB pointer to be used for IO for the station. 


A device code in the following format: 


Device 


Device Output Input 
Code 

0 POD PID of the station 
1 TTP TTK 
2 MTW1 MTR1 
3 MTW2 MTR2 
4 LP CR 

9 DOF DIF 

6 CLO = 

7 VK2 VP2 

8 MIF MOF 


Only one device, either input or output, can be re- 
quested at one time. 


Bit 23.1 for input, 0 for output 
X2 address of TVT table for the station 


X7 address of the device cre in TVT table for the 
station 


A eontents of the device entry (see the 
description of TPID, TMTRI, or TDOF.) 


BSM address + 1. error return (invalid device) 
BSM address + 2 normal return 


LDA _ device 
BSM*  GTTDV 


Registers Used 


Allowed Usage 


3.35 HEADER 
Reference Location 


Description: 


Input Parameters 


Output Parameters 


Return 


Calling Sequence 


Routine Used 
Registers Used 


Allowed Usage 


3.36 SPIOER 
Reference Location 


Description 


Input Parameter 
Output Parameters 


Return 


A, E, X7 are not restored. 


Foreground/background 


SYXVEC + 34 


This subroutine is used to output a standard header for 
the data accumulation overlays, the station number, 
test plan, name and serial number. 


A TSN (serial number) 

E station number (0 to 3) 

X6 IOATAB pointer for the output device. 
Output device must have been opened prior to 
calling this routine. 


A header line is output to the device. TOF is issued if 
the device is a line printer. 


BSM address + ] 


LDA TSN,TP 


LDE station 
LDX* X6 ,IOPT 
BSM* HEADER 
$IOCS 


A, E, and X7 are not restored. State switch 7 is used. 


Foreground 


SYXVEC + 35 

This subroutine checks error code returned from 
$1IOCS. If the device is busy, it returns to BSM address- 
2 for retry; otherwise, it outputs a message on the 
VKT and returns to the monitor. 

A $IOCS error code 


None 


BSM address-2 if the device is busy (A = 7). 


_ Otherwise, no return. 
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Calling Sequence 


Routine Used 
~ Register Used 


Allowed Usage 


3.37 FGOVC 
Reference Location 


Description | 


Input Parameter 
Output Parameters 


Return 


Calling Sequence 


Routine Used 


Allowed Usage 


3.38 ALLEX 
Reference Location 


Description 


Input Parameters 


Output Parameters 


LDX X1,DCB 
BSM* $10CS 
BSM* SPIOER $1OCS error return point 
ERRCNV 


A is not restored. 


Background only 


SYXVEC + 36 
This routine calls system overlays at foreground entry 
point. Reserved for operating system use only. 
Not reentrant. 

A assigned system overlay code 


None 


BSM address + 1 overlay not found 
BSM address + 2 normal return 


LDA overlay code 

BSM#* FGOVC 

-— error return 
-- normal return 


None 


Foreground only 


— SYXVEC + 37 


This subroutine is used to execute foreground portion 
of ALLINK overlay. If the called overlay is not in 
memory, it is loaded before executing it from the 
foreground entry point. 


A and E register must contain the six-character name | 


of the overlay left justified. 


None 
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Return BSM address +1 error return 


There is no room in memory to load, or overlay cannot 
be found on disk 


BSM address +2 execution complete 


Calling Sequence 


LDA namel 
LDE name2 
BSM* ALLEX 
BRU ERROR error return 
a normal return 

Routine Used SC NFIL 

Registers Used All registers and state switches are saved and 
restored. 

Allowed Usage Foreground only 

3.39 COMMND 

Reference Location SYXVEC + 38 

Deseription Allows return to the monitor after completing a pro- 
cess. COMMND can be used for a temporary return 
while waiting to be called by other programs (DEBUG 
waiting for an address halt to occur; return from 
baekground after scheduled by foreground). It is not 
normal termination of a foreground or background 
task and may not be used to indicate the completion 
of a process. 

Input Parameters None 

Output Parameters None 

Return No return 


Calling Sequence 
BRU* COMMND 
Registers Used Not applicable 


Allowed Usage | Foreground /background 
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3.40 PUTW 
Reference Location 


Description 


Input Parameters 


Output Parameters 


Return 


Calling Sequence 


Routine Used 
Registers Used 


Allowed Usage 


3.41 TWAIT 


Reference Location 


Description 


Input Parameters 
Output Parameters 
Return 


- Calling Sequence 


Registers Used 


Allowed Usage 


SYXVEC + 39 — 


This subroutine is used to pack a word in A register 


into the buffer specified by the caller. The word 


should be of four TRASCII characters. 


A four TRASCII characters 
X7 starting address of the three-word DCB 


None 


BSM address + 1 for buffer overflow 
BSM address +2 for normal return 


LDA CHARS 

LDX X7,PMFDCB 

BSM* PUTW 

a error return 
a= normal return 
PUTC 

X0, X1, and A are not restored. 


Foreground /baekground 


SYXVEC + 40 


This subroutine waits for the foreground activity to 
complete before returning control to the caller. 


None 
None 


BSM address +1 


BSM*  TWAIT 


All registers and state switches are saved and 
restored. 


Background only 
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3.42 FGBGRT 
Referenee Location 


Description — 


Input Parameter 
Output Parameters 
Return 


Calling Sequence 


BGADR 
Registers Used 


Allowed Usage 


SYXVEC + 4] 


This routine schedules the background part of a pro- 
gram from the foreground. _ 


X7 address of the background process to be activated 
None 


BSM address +1 


LDX X7,BGADR 
BSM* FGBGRT 
EQU 3 start of background process 


All registers are ‘restored. | 


Foreground only 


Note 


When the background is entered due to scheduling 
through FGBGRT, all registers are undefined. Refer to — 
paragraph 6.4 for additional information. 


3.43 MONINT 
Reference Location 


Description 


Input Parameters 
Output Parameters 


Return 


SYXVEC + 42 


This subroutine allows entering the scheduler loop 
once, so that the higher priority functions such as 
testing can regain control. Control returns to the 


- calling program if there is no higher priority funetion | 


waiting or at the next break of the higher priority 


function process. It is reeommended to call this rou- 


tine during a long calculation or if formatting of data 
is involved. 


None 
None 


BSM address +1 
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Calling Sequence 


Registers Used 
Allowed Usage 


3.44 SCALE 
Reference Location 


Description 


3.45 FGWAIT 
Reference Location 


Description 


Input Parameters 


Output Parameters 
Return 


Calling Sequence 


Registers Used 


Allowed Usage 


BSM* MONINT 


All registers and state switches are saved and 


restored. 


Background only 


SYXVEC + 43 


For use by THD only 


SYXVEC + 44 


This routine allows entering the scheduler once from 
foreground to allow the background to process. It is 
used by the program that requires ae be- 
tween the foreground and background. 


None. The program should maintain a flag to indicate 
that background has completed the process and is 
ready to accept next data. 


None 


BSM address + ] 


LDA flag BACKGROUND BUSY? 
BZ #43 NO, READY NOW 
BSM* FGWAIT _ YES, WAIT 


BRU —s_*-3 


All registers and state switehes are saved and 
restored. , 


Foreground only 
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3.46 ERRCNV 
Reference Location 


Description 


Input Parameter 


Output Parameters 


Return - 


Calling Sequence 


ERROR 


Registers Used 


Allowed Usage 


SYXVEC + 45 


This subroutine is used to output an $IOCS error 
message to the VKT. 


Error code 7 should be detected prior to calling 
ERRCNYV, since it is simply a busy condition. 


A register error code 
Code Message 


NONE 
END OF FILE INPUT 
DEVICE NOT AVAILABLE 
INVALID FUNCTION 
ERROR IN FILE - DATA 
FILE NOT FOUND 
I/O ERROR 
DEVICE BUSY 
INVALID I/O TABLE 
DATA OVERFLOW 
10 NO WRITE RING 
ll CLIO ERROR 
12 I/O TABLE OVERFLOW 
13. EXCESS WORDS IN READ 
14 WS NOT AVAILABLE 
15 MACTAB OVERFLOW 
16 DUPLICATE FILE | 
777 INTEGRATOR ERROR 


oOononw PWN H © 


BSM address +1 error return 
BSM address +2 normal return 


BSM* = $IOCS 
BRU ERROR 


BSM* ERRCNV 
NOP Ignore Error 


A, E, Xl, and X6 are not restored. 


Background/foreground 
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3.47 FSUB 
Referenee Location 


Description 


Input Parameters 


Output Parameter 
Return 


Calling Sequence 


Registers Used 


Allowed Usage 


3.48 FAND 
Reference Location 


Description 


Input Parameters 
Output Parameter 
Return 


Calling Sequence 


Routines Used 
Registers Used 


Allowed Usage 


SYXVEC + 46 


This routine subtracts a signed floating point value in 
E from a signed floating point value in A and returns 
the difference in A in floating point. 


A floating point number to be subtracted from (minuend) 
E floating point number to subtract (subtrahend) 


A signed difference in floating point (remainder) 


BSM address + 1] 


LDA VALI 
LDE VAL2 
BSM*  FSUB 


(VALI - VAL2) 


A and E are not restored. 


Foreground /baeckground 


SYXVEC + 47 

This routine applies logical AND operation to A and E 
and returns the result in A. A and E are fixed before 
logical AND is applied, hence, the values must be 
integers in floating point format, (no decimal frac- 
tions in A or E). 

A and E contain integers in floating point format. 

A contains the result in floating point format. 


BSM address + 1] 


LDA VALI 
LDE VAL2 
BSM*  FAND 
FFIX, FFLT 


A and E are not restored. 


Foreground /baeckground 
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3.49 FEOR 
Referenee Location 


Description 


Input Parameters 
Output Parameter 
Return 


Calling Sequence 


Routines Used 
Registers Used 


Allowed Usage 


3.50 FLOG 
Reference Location 


Description 
Input Parameter 


Output Parameters 


Return 


Calling Sequence 


Registers Used 


Allowed Usage 


SYXVEC + 48 

This routine applies exclusive OR to A and E and re- 
turns the result in A. A and E are fixed before 
exclusive OR is applied, hence, the values must be 
integers in floating point format. 

A and E_ contain integers in floating point format. 


A contains the result in floating point format. 


~BSM address + 1 


LDA VALI 
LDE VAL2 
BSM* FEOR 
FFIX, FFLT 


A and E are not restored. 


Foreground/background 


SYXVEC + 49 


This routine converts the floating point value in A into 
base 2 logarithm and returns the result in A. 


A contains a positive floating point value. 
A contains base 2 logarithm value in floating point 
format. OV indicator is set if the input is negative or 


Zero. 


BSM address + 1] 


LDA VAL 
BSM* FLOG 


A and E are not restored. 


Foreground /baeckground 
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3.51 FADD 
Reference Location 


Description 


Input Parameters 


Output Parameter 


Return 


Calling Sequence 


Registers Used 


Allowed Usage 


3.52 FDIV 
Reference Location 
Description 

Input Parameters 


Output Parameters 


Return 


Calling Sequence 


Registers Used 


Allowed Usage 


SYXVEC + 50 


This routine adds signed floating point values in A and 
E and returns the sum in A in floating point. 


A and E floating point values. 
A the sum. 


Overflow indicator is set if the overflow condition 
occurs, 


BSM address + ] 


LDA VALI 

LDE VAL2 

BSM* FADD 

A and E are not restored. 


Foreground/background 


SYXVEC + 51 


This routine divides the floating point value in A by 
the floating point value in E and returns the quotient 
in A in floating point. 


A the dividend in floating point. 
E_ the divisor in floating point. 


A the signed quotient in floating point. 
Overflow indicator is set for overflow or underflow. 


BSM address +1 


LDA VALI 
LDE VAL2 
BSM* FDIV 


(VALI/VAL2) 


A and E are not restored. 


Foreground /background 
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3.53 FFIXS 
Reference Location 


Description 


Input Parameter 


Output Parameters 


Return 


Calling Sequence 


Registers Used 


Allowed Usage 


3.54 FOR 
Reference Location 


Description 


Input Parameters 
Output Parameters 
Return 

Routine Used 


Calling Sequence 


Registers Used 


Allowed Usage 


SYXVEC + 52 

This subroutine converts a floating point number in the 
A register into a signed octal integer returned in the 

A register and the power of 10 multiplier returned 

in the E register. 


A the floating point number to be fixed (converted 
to an octal integer). 


A the signed octal integer equivalent of the floating 
point number 
E the power of 10 multiplier 


BSM address + 1 


LDA FPNUM 
BSM* FFIXS 


A and E are not restored. 


Foreground/baeckground 


SYXVEC + 53 


This routine applies logical OR to A and E and returns 
the result in A. A and E are fixed before OR is ap- 
plied, henee, the values must be integers in floating 


- point format. 


A and E integers in floating point format. 
A the result in floating point format. 


BSM address +1 


FFIX, FFLT 
LDA VALI 
LDE VAL2 


BSM* FOR 
A and E are not restored. 


Foreground /background 
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3.55 FNOT 
Reference Location 


Description 


Input Parameter 
Output Parameter 
Return 

Routines Used 


Calling Sequence 


Registers Used 


Allowed Usage 


SYXVEC + 54 

This routine applies logical negation to A. A is fixed 
before negation is applied, hence, the value must be 
an integer in floating point format. 

A integer in floating point format. 

A negated value in floating point format. 


BSM address +1 


FFIX, FFLT 


LDA VAL 
BSM* FNOT 


A and E are not restored. 


Foreground /baeckground 


Note 


A floating point number may be negated by use of the 
machine language TCA instruction. 


3.56 FEXP 
Reference Location 


Deseription 


Input Parameter 
Output Parameter 
Return 


Calling Sequence 


Registers Used 


Allowed Usage 


SYXVEC + 55 


This routine calculates the value 2" where n is given in 
the A register in floating point format. 


A signed exponent in floating point. 
A result in floating point. 


BSM address +1 


LDA EXP 
BSM* FEXP CALCULATE 2**EXP 
A and E are not restored. 


Foréground/background | 
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3.57 FMUL 
Referenee Location 


Description 


Input Parameters 
Output Parameters 


Return 


Calling Sequence 


Registers Used 


Allowed Usage 


3.58 FFIX 
Referenee Location 
Description 


Input Parameter 


Output Parameters 


SYXVEC + 56 


This subroutine is ealled for multiplying two floating 
point numbers together. The numbers are all 24 

bits. The first number is loaded in the A register 
upon entering this subroutine and the second number 
is in the E register. If the result of this multi- 
plication is too large (the characteristic is greater 
than 177 octal), then the overflow indicator (OV) 

is set upon exiting from the subroutine. If the product 
is too small (the characteristic is less than 101 octal), 
the end result is represented by zeros. 


The sign of the product follows the algebraic conven- 
tion (+. xt=+,+x-=-,-x-=+t). 


A value (floating point) of first number 
Evalue (floating point) of second number 


A signed product in floating point 
Overflow indicator is set if the end result is too 
big 


BSM address + ] 


LDA —-FPNUMI- 

LDE FPNUM2 

BSM* FMUL 

A and E registers are not restored. 


Foreground /background 


~SYXVEC + 57 


This subroutine is used to convert a floating 
point number in the A register into an octal integer 
returned in A register. 


A the floating point number to be fixed (i.e., to be 
converted to an octal integer). 


A the octal integer equivalent. 
If the floating point number is so small that its char- 


acteristic is less than 101B, then it is truncated 
as a zero octal integer. 
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Return 


Calling Sequence 


Registers Used 


Allowed Usage 


3.59 FFLT 
Reference Location 


Description 


Input Parameter 
Output Parameter 
Return 


Calling Sequence 


Registers Used 


Allowed Usage 


3.60 FFLTS 


Reference Location 


Description 


Input Parameters 


BSM address + |] 


LDA FPNUM 
BSM* PEFIX 


A and FE are not restored. 


Foreground/baeckground 


SYXVEC + 58 

This subroutine converts an octal number in the A 
register into a floating point number that is stored in 
the A register on exit. 

A signed octal integer 


A signed floating point number 


BSM address + | 


LDA OCTNUM 
BSM* FFLT 


A and E are not restored. 


Foreground /background 


SYXVEC + 59 


This subroutine converts an octal number in the 
A register and its power of 10 in the E register 
into a floating point number that is stored in the 
A register upon exiting. | 


Both positive and negative numbers are processed by 
this subroutine. 


A signed octal integer 
E degree of power of 10 


3-52 


Output Parameters A signed floating point number 


If there is an underflow (number is too small), 
then A equals 0. 


If there is an overflow (number is too large), the 
overflow indicator is set when exiting from this 
subroutine and the A register does not contain this 
floating point equivalent. 

Return BSM address + 1 


Calling Sequence 


LDA OCTNUM 
_LDE PWR10 
BSM* FFLTS 

Registers Used 7 A and E are not restored. 
Allowed Usage ~~ Foreground /background 
3.61 FCAM | 
Reference Location == SYXVEC + 60 
Description a, This routine compares the floating point value in A to 


‘the floating point value in E and returns indicators 
GT, EQ, LT, and BE. 


Input Parameters A and E registers contain floating point values. 
Output Parameters Indicators are set as follows: 

GT setif A>E 

E EQ setif A=E 

LT setifA<E 

BE set if any bit in A set corresponds to the bit set in E. 
Return | BSM address + 1 


Calling Sequence 


LDA VALI 

LDE = VAL2 

BSM* FCAM 
Register Used E register is not restored. 
Allowed Usage Foreground /background 


Note 


This routine maintains compatibility with other programs 
that use FCAM. The machine language instruction CAM 
may be used with floating point numbers. 


3.62 LOAD 
Reference Location 


Description 


Input Parameters 


Output Parameters 


Return 


SYXVEC + 61 


This routine loads files into memory from the 
specified IO device and makes entries into MACTAB. 
It ean be called from either foreground or background. 
If the loading device is a disk and the file is a test 
program, the file is not loaded into memory unless 
there is enough room to load completely. However, 
the entry is still made in MACTAB. 


A and E registers contain six-character file names, 
BSM address + 1 contains the expected file type. 


14B to 40B _—_ system overlay file codes 


(6B test program 

75B module test program 

74B _ string or any file without a header 

77B ALLINK overlay 

71B ALLINK overlay that must remain fixed in 
=] any one of above type 

eD 75 or 76 and KEEP 


BSM address + 2 contains the loading device code. 


0 default loading device 
2 magnetic tape unit 1 
3 magnetic tape unit 2_ 
5 disk 

6 8 CLI 


BSM address + 3 contains file expansion size in words. 


X7 start address of the file loaded in memory 
X5  MACTAB pointer where the entry is made 
A ~ error code for error return 


A error code from $IOCS if positive 
error message if negative: 
'PARM' Mllegal loading device code 
'SIZE' Insufficient room in MACTAB 
>'TYPE' Wrong file type | 
'NAME' File not found 


BSM address + 4 error return 
BSM address + 5 normal return 
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Calling Sequence 


Registers Used 


Allowed Usage 


3.63 DELFIL 
Reference Location 


Description 


3.64 RELOV 
Reference Location 


Description 


3.65 ATTA 
Reference Location 


Description — 


Input Parameters 


DLD file name 

BSM* LOAD 

DATA file type 

DATA device code 

DATA expansion size 
if -1 or 0, use word 6 
if 0, use this word 

DATA job number 

-- error return 

a= normal return 


None restored 


Foreground/background 


SYXVEC + 62 


For system use only. - 


SYXVEC + 63 


For system use only. 


SYXVEC + 64 


This routine attaches a file to a station or makes it 
busy. Before the overlay starts collecting data for a 
station or starts interactive process with a station, | 
ATTA should be ealled. The attached programs/sta- 
tions are indicated in the NAME command output. 
Calling ATTA prevents autoreleasing in a disk-based 
system. See DTTA for detaching. 


X5 MACTAB pointer of the file to be attached (at 
background and foreground entry points X5 is set 
to MACTAB for the overlay). If MACTAB pointer 
is unknown, call SCNFIL subroutine to locate the 
pointer. | 


A _ logieal station ID (0, 1, 2, or 3) to attach 
program to a station makes overlay busy. 
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Output Parameters 
Return 


Calling Sequence 


Register Used 


Allowed Usage 


3.66 — DTTA 
Reference Location 


Description 


Input Parameters 


Output Parameters 
Return 


Calling Sequence 


Register Used 


Allowed Usage 


None 


BSM address + 1 


LDX* X5,SAVX5 SAVX5 contains MACTAB 
LDA STAT pointer 
BSM* ATTA 

A is not restored. 


Foreground /background 


SYXVEC + 65 


This routine detaches a file from a station. 
See ATTA for attaching. | 


X5 MACTAB pointer of the file to be detached (at 
background and foreground entry points, X5 is 
already set). | 


A logical station ID (0, 1, 2, 3) for station 
related file; 4 to clear busy. 


None 


BSM address + ] 


LDX* X5,SAVX5 
LDA STAT 


BSM* DTTA 
Ais not restored, 


Foreground /background 


3.67 PAGTP 
Reference Location 


Description 


Input Parameters 


Output Parameters 


Return 


Calling Sequence 


Routines Used 
Register Used 


Allowed Usage 


3.68 FGBGWT - 


Reference Location 


Description 


3.69 FGBGH 
Reference Location 


Description 


SYXVEC + 66 


This routine reads a test program into memory in 

pages during testing. If the test program is currently 

in memory, the required block is read into the same 
memory area. If it is not in memory (bumped) due to 
other programs being released or loaded, it allocates 

the new test program area by releasing inactive programs 
and by bumping other test programs before it loads the 
test program. 


A current instruction number 
X5 the pointer to MACTAB for the test program 


X5 points to MACTAB for test program 


BSM address + 1] 
No return if error. | 


normal return 


Terminal errors: 


12 not enough memory space to page 
44 I/O error during paging 


LXA X5 X5 = address of MACTAB 
LDA TEP EP instruction pointer 
BSM* PAGETP 


-- normal return 
$1OCS, ADJMEM 


E is not restored. 


Foreground only 


SYXVEC + 67 


Reserved for system use. 


SYXVEC + 68 


Reserved for system use. 


3.70 FIN DVL 


Referenee Location 


Description 


Input Parameter 


Output Parameter 
Return 


Calling Sequence 


Routines Used 
Registers Used 


Allowed Usage 


3.71 FGIO 
Reference Location 


Description 


Input Parameters 


Output Parameters 


SYXVEC + 69 
Reserved for system use only. 


This routine converts a block or yariebié number of a 
variable, array, or global into the absolute location of 
the variable. The address is in the A register on exit. 
Internal cells are altered for use by ARITH which calls 
the routine when a statement references a variable. 
BNO contains the block number, VNO contains the 
variable number, and VLOC contains the absolute 
address. 


A eontains the bloek or variable number. Bits 12 
through 10 contain the block number, and bits 
9 to 0 contain the variable number. 


A contains address of the variable. 


BSM address + 1. 


BSM* = FINDVL 


None 


_ X7 and E registers are not restored. 


Foreground or background at a pause 


SYXVEC + 70 


This routine does I/O from foreground. Prior to eall- 


ing routine, the device must have been opened and set up 


by calling FGOH. This routine is used to output 
the data to the device used by DATALOG or 
FACTOR. If the MON button is depressed, out- 
put is suppressed. 


A IOATAB address returned from FGOH eall. 
X1 address of IOCS DCB 


None 
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Return 


Calling Sequence 


Routines Used 


Registers Used 
Allowed Usage 


Pe DMASTR 
Reference Location 


Description 


Input Parameters 
Output Parameters 


Return 


BSM address + 1 end of file on input 
BSM address + 2. normal return 


Error condition: 

The control branches to the terminal error processor 
if an error condition oecurs. No return is made 

to the caller in this case. 


Terminal Error 


40 I/O error 
45 Device is not opened 


LDA 1/O data from FGOH (BSM + 1) 
LDX X1,DCB 

BSM* FGIO 

NOP * | EOF return 


-— | normal return 
$IOCS, ERRCNV 


A and E are not restored, 
X1 (SP) is restored to the SVT pointer. 


Foreground only 


SYXVEC + 71 


This routine starts DMA and gives control to the back- 
ground. All interrupt bits are cleared, saving any 
enable bits, then the trap (bit 4), fail (bit 6), and reset 


(bit 12) interrupt enable bits are set in the status 


register. Bits 11 and 10 of the mode registers are 
cleared and bit 9 is set to start DMA. WAIT is called 
to give background control until an interrupt takes 
place. 

None 

None 


BSM address + 1] 


If tester reset is pressed while background has control, 
there is no return to the caller. 
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Calling Sequence 


Routines Used 
Registers Used 


Allowed Usage 


3.73 FGOH 
' Reference Location 


Description 


Input Parameters 


BSM* §DMASTR 
DWAIT is ealled, and ealls WAIT. 
The A register is not restored. 


Foreground 


SYXVEC + 72 . 


This subroutine keeps track of I/O device usage by 
Stations. If the device is a disk, magnetic tape, or 


eommunieation link, the device should open by ecom- 


mand: OPEN. It opens all other devices if it has 
not been used before. It keeps track of the type of 


output issued by using the header code. When it is the 


first use of the current I/O since the beginning of the 
test, the standard station header is SHAME before it 
returns to the caller. 


A device eode in bits 3 to 0. 
. PID/ POD of the current station 
TTK/TTP 

MTR1/MTW1 

MTR2/MTW2 

CR/LP 

DIF /DOF 

CLO (CLI is saa ad 

VP2/VK2 

MIF /MOF 


ON OT PWN HE O&O 


Bit 23 must be set to 1 for input device. 


E current line header code in bits 3 to 0. 
0 override output of station header 
] datalog trip 
2 , datalog measure /DCT 
4 datalog FCT 
7 datalog PPM memory fail 
8 datalog PPM data extension 
9 FACTOR write/FACTOR pause 
13 to 15 Reserved for ALLINK generated headers 


X2  TVT address of the station 
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Output Parameters BSM address + 1 contains the device pointer required 
by FGIO. It is the contents of the device variable 
in station global table such as TPOD or TLP (see 
the deseription in TVT table deseription). 


Bit 22 set to 1 indicates that binary formatting is 
required for this device. 


Return BSM address + 2 


The current output is not the same type as the last one 
or the output requires binary format. 


’ BSM address + 3 


The current output is not the same type as the last one 
and needs a line header (Datalog FCT after DCT 
output). 


BSM address + 4 

The current output is the first output to this device 
Since the beginning of the test, hence, the station 
header has been output. 


Error condition: 


If the device is a disk, magnetic tape, or 
communication link, and it has not been opened by the 
eommand OPEN or SET, then the control 

_ branches to terminal error 42. 


If the device code is invalid, the control branches to 
terminal error 43. 


Calling Sequence 


LDA device code 
LDE header code 
|  BSM* FGOH 
IOPT DATA — 0 Device pointer put in here 

-- | No header change return 
rales Header change return 
== First output return 

Routines Used GTTDV, FGOPEN, HEADER 

Registers Used _ A and E are not restored. 


X1 (SP) is restored to SVT pointer. 


Allowed Usage Foreground only 


3.74 == ENBTST 
Reference Location 


Description: 


Input Parameters: 


Output Parameters 
Return 


Calling Sequence 


Routine Used 
Registers Used 


Allowed Usage — 


3.75 WWAIT 
Reference Location 


Description 


Input Parameters 


Output Parameters 


SYXVEC + 73 


This routine initiates a functional test by writing the 


‘contents of the A register on entry to SAMA. The 


user should enable the clock timeout interrupt and 
write the clock register before entry if a timeout is 
required (MATCH or EXT). This routine then enables 
the FCT interrupt (set bit 6 SR), and enables the 
tester busy interrupt (set bit 16, reset bit 17 SR). 
Then SAMA is written. Generally, WWAIT should 

be called following the call to ENBTST to pass control 
to the baekground. 


A must contain the data to be written to SAMA. 
- Bit 0 must be set to begin testing. 


None 


BSM address +] 


LDA SAMA data 
BSM* ENBTST 
BSM* WWAIT 


EN TBSY is called to enable the tester busy interrupt. 


A and E registers are not restored. 


Foreground 


SYXVEC + 74 

This routine turns control over to the background 
until the tester busy flag set by ENBTST or ENTBSY 
is reset. 


None 


None 
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Return 


Calling Sequence 


Routines Used 
Registers Used 


Allowed Usage 


3.76 ADRXLA 
Reference Location 


Description 


Input Parameters 


Output Parameters 


BSM address +1 


If WWAIT is called by a foreground program and 

tester reset is pressed, there is no return to the 

ealler. If WWAIT is called by a background program, 
reset causes control to be returned to the caller. 

In this ease, bit 10 to 13 of RSTTSC (GLOVAR + 

106) indicates that reset was pressed. The program 
should cheek for reset following a call to WWAIT. 

In most eases when the station is reset, the background 
program should exit. 


LDA SAMA data 
BSM* ENBTST 
BSM*  WWAIT 


DWAIT is ealled and calls WAIT. 
All registers are restored. 


Foreground/background overlays using the tester 


SYXVEC + 75 


This routine translates the relative address of a word 
in a file into an absolute address of the word in a 
memory buffer. If the word is not currently in 
memory, the current buffer contents are written back 
to the file (if its contents have been modified) and a 
new portion of the file is read into the buffer. 


The current contents of the buffer ean be written 
back to the file by calling with a relative address of -l. 


X6 I/O assignment table pointer 

X7 pointer to three-word DCB for memory buffer 
word0 0 | 
word 1 buffer address 
word 2. buffer word count 


A relative address of word in file (or 
-] to foree the current buffer contents to be 
written back to file) 


A address or word in memory buffer 


(relative to current relocation register) 
X6,X7 unchanged 
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Return 


Calling Sequence 


Routines Used 
Registers Used 


Allowed Usage 


3.77 INTERP 


Reference Location 


Description 


Input Parameters . 


Return 


Calling Sequence 


BSM address +1 on error 
A= 0 address error 
A= nonzero’  $IOCS error code 
BSM address +2 for normal return 


~LDX X6,1/O assignment table pointer 


LDX: X7, buffer DCB 

LDA -—~_—oword relative address in file 

BSM* ADRXLA 

BRU ERROR error return 
-- | 7 : normal return 
$IOCS 

A, X6, X7 


Foreground /background 


SYXVEC + mi 


This call accesses the THD interpreter for processing 
a data code in the 500 or 600 series. Any tester func- 
tion desired that directly eorresponds toa FACTOR ~ 
code may be done by a call to INTERP. Care must be | 
taken to return any system cells used to their previous 
state. For example, if a measurement is done by a . 
call to INTERP, STHC records the measurement and 
any pass/fail information. This triggers the data- 


_ logger and lights the pass/fail lamps unless STHC is 
_ restored to its previous state before an exit of the 
—user overlay. The IND register should be restored 


by an overlay calling INTERP. 


X1_ pointer to SVT table 


X2 pointer to TVT table 


A opcode in acceptaek form 


BSM address +1 IND has not been incremented 


BSM address +2 IND has been ineremented 


LDA —— opeode 


BSM* INTERP | 
NOP 0 


se | return 
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Routines Used Any interpreter routines 


Registers Used Depends on opcode 

Allowed Usage Foreground 

3.78 ENTBSY 

Reference Location SYXVEC + 77 

Description This routine enables the tester busy complete inter- 


rupt and turns off the tester busy interrupt bit (SR bit 16 
on, bit 17 off). A flag is set to indicate that the 
interrupt is enabled. The flag is reset by the tester 
busy interrupt routine. Either before or after the 

eall, some activity must be done to generate a tester 
busy interrupt. This routine then enables the interrupt. 
Generally WWAIT is called, following the call to 
ENTBSY, to wait for completion in the background. 

If the interrupt has already occurred WWAIT does 

not pass control to the background, since this would 
cause a hang condition. — 


Input Parameters None 

Output Parameters None 

Return | BSM address +1 

Calling Sequence Initiate activity which generates interrupt 
BSM* ENTBSY 
BSM* WWAIT 

Routines Used None 

Registers Used The A register is restored. 

Allowed Usage Foreground 

3.79 RSOVC 

Reference Location SYXVEC + 78 

Description This routine calls foreground overlay at the reset 


entry point if an overlay was running at the time the 
reset was pressed. Reserved for system use. 


Input Parameters None 


Output Parameters None 


Return 


Calling Sequence 


Registers Used 


Allowed Usage 


3.80 STALL 
Reference Location 


Description 


3.81 UPDATE 
Reference Location 


Description 


Input Parameters 


BSM address + 1] 


BSM* RSOVC 


All registers and state switches are restored. 


Foreground only 


SYXVEC + 79 


Reserved for system use. 


SYXVEC + 80 


This subroutine creates, assigns, or deletes memory or 
disk files. Before a file is created, the remaining data 
in the block is written out to working storage ifa_ 
bloek buffer has been specified and the current block 
pointer in IOATAB is non-zero. The working storage 
file is closed after the file is created. Word 10 of the 
IOATAB entry specifies the number of words used. If 
word 10 of the IOATAB entry is zero, assigning a 
space rather than creating a file is assumed. The A 
register must contain the assigning size. 


The second option changes the file name on disk or in 
memory so that the file becomes obsolete. 

The first character of the obsolete file name is 
changed to an ampersand. 


BSM _ address + 1 contains the option code. 
0 create 
1 delete (name change) 

BSM _ address + 2 and 3 contain the file name 
left justified. sR 
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Output Parameters 


Return 


For create, 

BSM _ address + 4 contains the file type. Word 
must never be zero. Bits 23 through 6 are 
reserved for future expansion. 


14B to 30B system overlays 


71B ALLINK/Overlay 
72B DATA 

73B | OBJECT 

74B string 

T5B module test 

76B test plans 

T7B ALLINK /overlay 


If the device is a disk, the file type is mapped to disk 
file type as follows: 


14B to 30B, 77B  coreimage 
72B,75B, 76B data 

73B OBJECT 
74B string 


BSM address + 3, for delete option only, contains the 
device code. 


10B MIF 
9B DIF 


X6 IOATAB pointer of WS (create only) 
A number of words to assign for zero word 
used | 


A Contains the $1OCS error code for error return. 


2 the device is not the memory or disk or 
the file is not a working storage 
9 insufficient block size or file overflow 
8 invalid I/O assignment 
14 MACTAB overflow for memory file 
16 duplicate file 


BSM address + 4 error return 
BSM address + 5 normal return 
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Calling Sequence 
For create: 


LDX* X6, IOAPT 
BSM* UPDATE 
DATA 0 

DATA namel,name2 
DATA filetype 


BRU ERROR 

-- normal return 
ERROR BSM#* ERRCNV 

NOP - QO 


For delete: 


BSM* UPDATE 

DATA 1 

DATA —_ namel,name2 

DATA device code (5B/10B) 


BRU ERROR 
— a | normal return 
ERROR BSM* ERCNV 
NOP 0 
Routines Used | $IOCS, ADJMEM, SCNFIL, STALL 
Registers Used A and E registers are not restored. 
Allowed Usage - =  ~—_—_:sCOForeground/background 
3.82 PUTENG 
Reference Location SYXVEC + 81 
Description | This subroutine converts a floating point number to 
printing format, a four-digit integer, engineering for- 
mat, or scientific format and places it in the buffer. 
Input Parameters A a floating point number 


X7 starting address of three-word DCB (used 
by PUTC, PUTD) 

E For engineering format, use letter. 
For secientifie format, use 0. 


Word 0 of the DCB points to the next available 
eharacter. 
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Output Parameters 


Return 


Calling Sequence 


Routine Used 
Registers Used 


“Allowed Usage 


Converted number in the buffer. 


For E=0: 


If the floating point number is an integer and the 
magnitude is between - 999 and 9999, the format is 
is - nnn to nnnn. 


For all other numbers, the format = +n.nnnE#tnn. 
The decimal point moves left or right in order 
to make the characteristic multiple of three. 


For E = letter: 


If the floating point number is an integer and the 
magnitude is between -999 and +9999 the format 

is -nnntm1l to nnnntml. Where m is the magnitude 
and 1 is the letter entered in the E register. 


For all other numbers, the format is tn.nnntml. 
The decimal moves to the left or right so that the 
magnitude represents a multiple of three. 


The magnitude is represented as follows: 


T Tera Et12 


M Milli E-3 
G Giga E+9 U Micro E-6 
M Mega E+6 N Nano E=9 
K Kilo E+3 P Pico E-12 

F Femto E-15 


BSM address +1 


LDA FPNUM 

LDX X7, DCB 

BSM* PUTENG 

PUTD, PUTC, CONV, FFIXS 
A,.E, X1, SW7 are not restored. 


Foreground /background 
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383 PUTA 
Reference Location 


Description 


Input Parameters 


Output Parameters 


Return 


Calling Sequence 


Routines Used 
Registers Used 


Allowed Usage 


3.84 BGCHK 
Reference Location 


Description 


Input Parameters 
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This routine converts a binary number to either octal 
or decimal and places it in the output buffer. Either 
PUTO or PUTD is used. The routine outputs decimal 
if the system is configured for decimal output by bit 
19 of MINIT set to zero. Leading zeros are suppresed. 
If MINIT is set to 1 the output is octal. Leading 
zeros are not suppressed for octal output. This 
routine is used throughout the system for outputting 
local memory addresses. 


A positive binary 
X1 number of digits 


X7 PMF pointer 


0 and X7 are adjusted to point to the next character 
position. 


BSM address + ] 


LDX X1, length 


LDA binary number 
LDX | XT,DCB 


BSM* PUTA 
PUTO or PUTD 
A and X1 are not restored. 


Foreground /background 
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This subroutine checks for background activity. There 
are two options. The first checks for no activity, by 
testing from foreground. The other option checks for 
more than one background task. It allows testing from 
a background task to see if there is any other 
background task active. 

A 0 Cheek for no background only 
l Check for one background 

2 Check for no overlay 

3 Check for one overlay only 


Output Parameters 


Return 


Calling Sequence 


Routine Used 


Registers Used 


Allowed Usage 


3.85 ~ CALLMOD 
Reference Location 


Description 


Input Parameters 


Output Parameters 


Return 


None 


BSM address + 1 
BSM address + 2 


LDA cheek code 
BSM* BGC HK 


None 
A and E are used and not restored. 


Foreground /background 
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This subroutine provides a means to eall another 
overlay module from an overlay module. 


When the overlay calls a module using this routine, 
CPU control is transferred to the module at the mod- 
ule entry point after the relocation register is set to 
the address specified by the calling module. It returns 
to. the calling module when the called module returns | 
control to CALLMOD. | 


The sequence that oceurs when the call to CALLMOD 
is executed starts at the module entry point in the 
module. First, the parameter following the call 

is retrieved and the return address is incremented. 
The address field of the parameter is used as an 
index to the module linkage table. The true BSM 

or BRU instruction is extracted from the linkage 
table and stored in the program execution path 

to be executed later. 


A register contains the starting address of the called 
module in absolute address. 


All other registers and switches are transferred to the 
calling module as they are. 


All registers and switches returned from the called 
module are transferred back to the calling module. 


Defined by modules. 


Calling Sequence 


Routines Used 
Registers Used 


Allowed Usage 


LDA module address 
BSM* CALLMOD 


None 
A is undefined on return. 


Foreground/background 


Rules for module programs callable by CALLMOD: 


3.86 ~ PUTB 
Reference Location 


Description 


Input Parameters 


Output Parameters | 


Return 
Calling Sequence 


DCB 
BUF 


Routines Used 


Allowed Usage 


The standard overlay header must be maintained. 
It is always called at the module entry point. 
Header word 8 is used to store the relocation register of the calling program. 
Header word 9 is used to store the return address of the calling program. 
Return to the calling module must be done through the module entry point. 
Header word 9 may be incremented to control the return address. 
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This subroutine converts a binary number to binary 
TRASCII and places it right justified in the buffer. 


A positive binary number 
X1 number of digits desired 


X7 DCB pointer 


0 and X7 are adjusted to point to the next character 
position. 


BSM address + 1 


DATA 0, BUF,20 


BSS _—-_-20 | 
LDA. binary number 
LDX X1,8 

LDX X7,DCB 


BSM* PUTB 
A and X]1 are not restored. 


Foreground /Background 


3.87 PUTH 
Referenee Location 


Description 


Input Parameters 


Output Parameters 


Return 
Calling Sequence 


DCB 
BUF 


Routine Used 
Registers Used 


Allowed Usage 


3.88 SAVENV 


Referenee Location 


Description 


3.89 USVENV 


Reference Location 


Description 


SYXVEC + 87 

This subroutine converts a binary number into 
hexadecimal TRASCII and places it in the buffer right 
justified. 

A positive binary number 
X1 number of digits desired 
X7 DCB pointer 


SW7 set do not suppress leading zeros 
SW7 not set suppress leading zeros 


0 and X7 are adjusted to point to the next character 
position. 


BSM address + 1] 


DATA 0,BUF,20 


BSS 20 

LDA binary number 
LDX X1,8 

LDX X7,DCB 


BSM * PUTH 
PUTC 
A and XI are not restored. 


Foreground/Background 
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Reserved for interrupt system use. 


SYXVEC + 89 


Reserved for interrupt system use. 


I/O Control System ($IOCS) 


4.1 


$IOCS 


All I/O functions must be accomplished through $IOCS to preserve foreground/ 
baekground configuration. $IOCS is closely tied to the task scheduler and is a re- 
entrant routine (it can be called any number of times at any point by any number 
of tasks). 


4.1.1 $1OCS Operation 


$1OCS operation is based on the following principles: 


Devices are available to any program on a first-come-first-served basis, 
except for the keyboard (TTK), which ean be overridden by the TTP. 
Devices on the same channel can be active only one at a time. One more 
request can be accepted while the channel is busy and is waiting for the chan- 
nel release by the first request. : 
Device protection on a channel is on a function basis. This means that a 
ehannel is busy while processing a function such as reading a record or 
rewinding. It does not prohibit other channels from being activated. 

One program may use any number of devices or may use the same device for 
two or more different purposes. For example, read a file from the disk and 
write another file on the disk. 


I/O completion is defined as having one of the following conditions fulfilled: 


In an input operation, a terminating character is received. 
In an output operation, the end of buffer is reached. 
A terminating interrupt.from a device is obtained. 
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@ The character set used internally by the system is in TRASCII code. $10CS 
makes conversion just prior to sending it out or after reading it in if the exter- 
nal data mode is different from the internal mode in normal mode. (See ASCII 


control mode) 


TTK/VK2 

TTP, LP, VP2 

CR 

MTR1, MTR2 

MTW1, MTW2 

DIF, DOF, MIF, MOF 
CLI (binary read) 

CLI (alpha read) 

CLO (binary write) 
CLO (alpha write) 


ASCII TRASCII 
TRASCI ASCII 
BCD TRASCII 
No conversion 
No conversion 
No conversion 
No conversion 
ASCIE TRASCTII 
No conversion 
TRASCII ASCII 


@ All read or write requests are initiated by OPEN and terminated by CLOSE. 

e Data on all devices are read or written sequentially forward from the 
beginning of the file. Random access on a disk file must be controlled by the 
user, using the I/O assignment table provided. _ 

@ All I/O operations are considered WAIT FOR COMPLETION unless otherwise 
specified. 

@ A maximum of two requests on the same channel ean be entered. If the third 
request is the same file as the one pending (same device, same program, same 
file), the last request overrides the one pending unless otherwise specified. 

e If a function requested is meaningless to the device, it is treated as NOP 
(return as if completed); for example, TOP-OF-FORM on magnetic tape. 

@ Read from TTK always echoes the character to TTP in normal mode. | 

e ASCII control mode for VKT: | | 


Read Data characters are echoed to sereen and are packed into buffer 
in TRASCI (four characters per word). As soon as a control character 
is sensed, it is placed in the last word of eure + ] right justified and 
control is returned to the caller. 


Write Output is specified by the chafacter count. Characters are 
_ stored in ASCII (three characters/word) left justified. 
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4,1.2 


Devices Handled by $IOCS 


Device Mnemonic Code Transfer Mode 

VKT keyboard / Character by character 

printer TTK/TTP l interrupt 

Magnetic tape | 

unit 1 MTR1/MTW1 2 DMA 

Magnetie tape | 

unit 2 MTR2/MTW2 3 DMA 

Card reader CR 4 DMA 

Line printer LP | 4 Bloek transfer through 
hardware buffer 

Disk file DIF /DOF 9) DMA 

Com link to CLI/CLO 6 Character by character link to 

Integrator interrupt 

VKT2 VK2/VP2 7 Character by character 
interrupt 

Memory file MIF /MOF 8 Word by word move 


4.1.3 


Code 


Functions Performed by $IO0CS 


Function 


Open (request to reserve the usage of a device) 

Read/write a record | 

Kill input (TTK/CLI only) /elear VKT sereen (foreground and 
background ) 

Top of form on line printer 

Unformatted write (write TTP without CR/LF) /file transmit — 
(create to CLO) 

Skip file on magnetic tape/file end to CLI 

Rewind magnetic tape/file end (process) to CLO 

Write EOF on magnetic tape/file end (purge) to CLO 

Status check on magnetic tape and disk 

Read without transfer on magnetic tape and disk for verification / 
file end (hold) to CLO | 

Close (release the usage of a device) 

File request to CLI/magnetic tape record skip 

Control message to CLO/file page from DIF/MIF 

Disconnect CLI/CLO/VKT screen transmit 

File transmit (ADD) 

Reserved 
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4.1.4 


Error Detected by $IOCS 


An error code is returned in the A register upon error exit from $IOCS. 


Code 


4.1.5 


Description 


An end of file has been reached on a read operation 

An invalid device code is used for the function or device not 
available 

An invalid function code is in the DCT 

Parity error on a read magnetic tape/CLI/ DIF read error on ecard 
reader 

File not found on DIF/DOF/CLI 

Undefined magnetic tape error/unrecoverable CL error 
Device busy (both active and pending occupied) 

Invalid I/O assignment table address is used 

Insufficient block size or file overflow for DOF/MOF 

No write ring on magnerle tape 

CLIO error 

I/O table overflow 

Excess word count on read 

Disk working storage already in use 

MACTAB overfiow for MOF | 

Integrator/RTE error nn 


Definition oF End-of-File 


While reading a ne $10 CS recognizes an end of file when the > following condition 


occurs: 


Device 
TTK/VK2. 


MTR1/MTR2 
CR 


DIF 


CLI 
MIF 


Condition 


// shataeier in column 1 and 2 and no other character 
in the record | 
Sensing a file mark 
// characters in column 1. and 2 ena) no other character 
on the eard 
Number of words so far eeaenes the file size specified 
in the directory 

- Sensing a file end message 
Number of words so far reaches the file size specified 
in MACTAB — 
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4.1.6 Definition of End of Reeord 


While reading a record, $IOCS recognizes an end of record when the following 
eondition occurs, 


Device Condition 
TTK/VK2 Sensing a carriage return character 
MTR1/MTR2 Sensing a record mark 
CR Sensing a completion interrupt 
DIF, MIF 
not blocked Sensing a completion interrupt 
bloeked-source Sensing a 77B character 
bloeked-variable Number of words obtained = record size 
size-data Specified in the first record word (Bit 7 to 0) 
bloek ed-fixed | Number of words obtained = record size 
size-data Specified in the directory 
CLI Sensing ETX during message type 3 transfer 
4.1.7 General Calling Sequence 


All read and write functions must be initiated by an OPEN call and terminated by 
a CLOSE eall. If the OPEN is successful, a pointer to I/O assignment table is 
returned to the calling program. This pointer must be set to X6 for all read or 
write in that device. 


Three or four other parameters must be passed to $IOCS. The location of the 
first parameter must be specified in index register X1 and all other parameters 
must be in consecutive memory locations. 


Parameter | Contains input/output indieation, function, device code, 
and other control information particular to the function 

Parameter 2 Contains the address of the buffer 

Parameter 3 Contains the buffer size (number of words to be transferred) 

Parameter 4 Contains the job number (OPEN call only) 


Parameter 5, 6 Contains the file name (OPEN call only) 
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Example of general calling sequence: 


XXXXXXXXB 


OPNDCB DATA OPEN KEY WORD 
DATA BLKBUF BLOCK BUFFER ADDR 
DATA 48 BUFFER SIZE 
DATA 0 CURRENT SIZE 
DATA 0,0 FILE NAME 

* 

RDCB DATA XXXXXXXXB READ KEY WORD 
DATA INBUF RECORD BUFFER ADDR 
DATA 20 RECORD SIZE 

* 

RCLOSE DATA 52000000B CLOSE KEY WORD 
LDX X1,O0PNDCB 
BSM * $IOCS OPEN CALL 
BRU OPERR ERROR RETURN 
STX X6,IOPTR SAVE IOATAB PTR 
LDX* X6 ,IOPTR GET IOATAB PTR 
LDX X1,R DCB 
BSM* $IOCS READ CALL 
BRU RDERR 
LDX* X6 ,IOPTR GET IOATAB PTR 
LDX X1,RCLOSE 
BSM* $IOCS 
BRU ERROR 

4.1.8 Mechanism 


$IOCS is divided into three parts: initializing I/O request, driving I/O device, and 
terminating I/O request. 


l. Initialization of I/O request. This occurs at the time of OPEN request and 
the majority of work is internal housekeeping. Unless the device is a commu- 
nication link or disk, the hardware is not involved at this time. $IOCS assigns 
the device to the requesting program by entering necessary information into 
the I/O assignment table and returning the entry pointer to the program to be 
used for read/write operation. 


2. Driving I/O device. This part of $1OCS is divided into three sections: 
I/O initialization, interrupt service, and I/O completion. Though functions 
performed in these sections differ depending on the device type, the follow- 
ing funetions are common to all devices: 


@ Decoding of keywords 

e Stacking the request as pending if the device is not available 

e Setting up the device into a ready state by sending out control 
functions (for example, an ESCAPE code to clear the VKT interface 
circuit before reading or writing to it) 

e Turning on the interrupt enable flip-flop on a selected device 
(PON) and turning on the CPU interrupt system (IEN) after setting up 
the device for the operation | 


3. Termination of I/O Request. Completion of I/O function is always detected 
in an interrupt service. When this condition oceurs, a scheduler flag for the 
channel is set so that the control returns to the end of channel process. If 
another request is pending for the channel, it is started immediately before 
returning to the current request. 


4.1.9 _ I/O Device Formats 


Aree Qel VKT DRIVER 


A character is transferred between the CPU and an I/O device through the 
accumulator bus. Each character transfer is accompanied by an interrupt. The 
process continues until, on output, the buffer has been exhausted, or on input, the 
buffer has been filled or a terminating character (carriage return) has been 
received. On output, a line feed and a carriage return, characters (12B, 15B) are 
sent out at the end of the buffer transfer. 


4.1.9.2 LINE PRINTER 


Data characters are written to the printer hardware buffer until the hardware 
buffer is full. The size of the buffer differs depending on the printer model. 


Buffer Size | Model Columns 
20 characters Data Products 80 
24 characters Data Products 132 

132 characters Centronies/Printronix 132 


If the output message exceeds the length of the respective line printer hardware 
buffer, it ean be printed as a multiple hardware buffer dump. An interrupt oceurs 
at the end of a hardware buffer dump (after printing one buffer of characters). 
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4.1.9.3 MAGNETIC TAPE 


A bloek of data is transferred between the CPU memory buffer and the tape in 
DMA mode. Between 6 and 16 thousand words can be transferred in one read or 
write operation. At the end of one transfer, an interrupt occurs. The status of 
the device can be obtained through the accumulator bus. The record gap is auto- 
matically written after each block write. At the end of a file, a file mark is sent 
as a file terminator. Up to 10 retries are made on parity error. 


4.1.9.4 CARD READER 


Data characters are transferred in BCD format from the card reader to the CPU 
memory buffer in DMA mode. One to 20 words can be transferred at one read. At 
the end of one transfer, an interrupt occurs. The card reader status can be 
obtained through the accumulator bus. 


4.1.9.5 DISK 


A block of data is transferred between the CPU memory buffer and disk in DMA 
mode. A block must be in multiples of 48 words; the maximum is 64 thousand 
words. At the end of one transfer an interrupt occurs. The disk status can be read 
through the accumulator bus. Up to 10 retries are made on parity error. Verifica- 
tion is applied immediately after each write operation. 


$IOCS provides functions similar to INREC/OUTREC if the user provides a block 
buffer that is different from the record buffer. 


On input $I1OCS reads one or more sectors into the block buffer and transfers 
to one record at a time at each read request. 


On output At each write request, $IOCS places a record into the block buffer 
and transfers the block when it becomes full or at CLOSE request. 


4.1.9.6 COMMUNICATION LINK 


Each record is preceded and followed by line protocol. Each character, once the 
record is initiated, is accompanied by an interrupt. A character is transferred 
between the CPU and the I/O channel through the accumulator bus. The process 
continues until, on output, the buffer has been exhausted, or on input, the buffer 
has been filled or a terminating character (ETX) has been received. There is a 
112-character buffer to accumulate a note message which could be received at any 
point in time. | | 
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4.2 I/O ASSIGNMENT TABLE (IOATAB) 
The I/O assignment table consists of 20 entries. Each entry (figure 4-1) contains 


13 words, for a total of 260 words. The first six words are reserved for use by 
system. Word formats are described in table 4-1. 


FDSTAT 


FNAME1 First Four Characters of File Name 


FCBBP Current Block Address 
FBBADR Block Buffer Address 
FBBSIZ Block Buffer Size 


FCSIZE Current File Size 


Figure 4-1 I/O Assignment Table Entry 
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Table 4-1 Word Formats 
Word 0: FDSTAT 
BS (Bit 23) 
DM (Bit 22) 


EF (Bit 21). 


BK (Bit 20) 


CM (Bit 14) 


Q Entry not used. Entry is used when set to l. 


| I/O is active or pending. Turned on when a request — 


with an immediate return is accepted and cleared 
when that I/O is completed. 


Binary data format; 0 = ASCII. 


EOF has occurred on CLI. It signals CLOSE function 
MSG TYPE 5 instead of KILL input. 


Auto blocking by $1OCS requested for disk and 
memory files. Transfer one record at a time to or 
from the block buffer. 


PID is a command file and the last command has not 
been completed. Cleared as soon as the command is 


| completed. — 


LM (Bit 13) 


BM (Bit 12) 
WS (Bit 8) 


IF (Bit 4) 


(Bits 3 to 0) 


Word 1: FNAMEI 


Loek out a command from being entered from this | 
PID, | 


Block has been modifed. Used by ADRXLA. 
Working storage I/O. 

I/O is input. 

Device Code © 


VK1/VP1 
MTR1/MTW1 
MTR2/MTW2 
~CR/LP 

DIF/DOF 
CLI/CLO 
VK2/VP2 
MIF/MOF 


ON DOO PWN 


First four characters of the file name in TRASCIL/ 


MACTAB address for MIF/MOF. 


Table 4-1 Word Formats (Continued) 


Word 2: FNAME2 
Bit 23 to 12 


Bit 2 to 0 


Word 3: FJOB 


Word 4: FDADDR 
Word 5: FSIZE 


Word 6: FCBBP 


Word 7: FBBADR 


Word 8: FBBSIZ 
Word 9: FCDADR 


Word 10: FCSIZE 


P (Bit 23) 


Word ll: FRSIZ 
Bit 9 to 0 


Last two characters of the file name in TRASCII. 


File type 

000 Source 

001 Fixed size data file 

010 Object 

011 Coreimage 

101 Variable length data file 


Job number in TRASCII. 


Starting disk address of a disk file in binary 
sector/starting memory address of a memory file. 


Number of words used for input. Number of words 
available for output until it is closed. 


Current block address (0 through FBBSIZ) relative to 

the first word of the block. Used by auto blocking and 
close. Word count for data files; character count for 

source files. 


Block buffer address in the user's program. 


Block buffer size in words; must be in multiples of 48 
words for disk files. 


Error code detected during immediate return I/O; 
otherwise, 0. 


_ Number of words already read or written; updated at 
‘the end of each read or write. If auto blocking is 
used, it corresponds with the block data rather than 


the record data so far processed. 


When auto blocking with a partial buffer, bit 23 is 
also set. 


Record size for fixed-length data files. At open 


time, set to the size in the disk directory or 18 
words. At close, written back to disk directory. 


a. 


4.3 


OPEN CALL TO $IOCS 


Purpose To initialize read or write operation. 
Description $IOCS checks for the availability of the device and 
assigns an entry in I/O usage assignment table. 
Depending on the device type, the following additional 
funetion is performed: 
Device Function Performed Error Condition 
TTK/TTP Status check Not available 
LP Status check Not available 
CR Status check Not available 
MTR Status check Not available 
MTW Status check Not available or write ring off 
DIF /DOF Directory search Not available or file not found 
CLI Open at the Integrator Not available or file not found 
CLO Open at the Integrator Not available or duplicate file 
VK2/VP2 Status check Not available 
MIF /MOF MACTAB seareh File not found 
Entry Parameters Xl address of six-word DCB 
Globals LOTNUM (three words), DEVNUM (two 
words), CATGRY (three words), contains file 
identification if the device is a CLI or CLO and 
the station identification in DCB word 0 is not 
zero. These variables are ignored for all other 
cases. 
DCB Word 0 
td 
23 18 14 13 12 11 10 3 0 


s . . 
,f : an a 
' wh if a i f ie 
& te ee 


0 = output, | = input 

function code = 0 

device code 

0 device specified in global CMDV 
(process routine sets it). If CMDV = 0, 
the system PID/POD. 


5 > a 


D device eode (eontinued) 
TTK/TTP 
MTR1/MTW1 
MTR2/MTW2 
CR/LP 

DIF /DOF 

CLI/CLO 

VK2/VP2 

MIF /MOF 


ONOOBRWDHY HY 


M Data transfer mode a 
0 Alpha --.. “©? 
] 


z gw Ter 


B . Auto block requested ~ “**- Awol 
No blocking pana ies 


6 » 
SS ew é 
ey 
x 


A 1 Append open (CLO only); otherwise 0 


ST Strobed download for communication link 
(ST bit must also be set on each read) 


S Station identification 
0 Non-station related background function 
1 Station 1 
2 Station 2 
3 Station 3 
4 Station 4 
DCB Word 1 Block buffer address or 0. 
DCB Word 2 Bloek buffer size in multiples of 48 words or 0. 


The block buffer supplied in open is used only if the device is DIF/DOF, 
MIF/MOF, or MTR/MTW and bit 11 of DCB word 0 = 1. 


Input Read a block from disk if the block buffer is empty. 
Transfer one record from the block buffer to the re- 
eord buffer., 


Output Move a record from the reeord buffer to the block 
buffer. Write a block to the disk if the block is full. 


The record buffer is supplied at the time of read or write call to $I0CS. Auto- 
matic blocking is provided to file type 000 (source), 001 (fixed size data), and 101 
(variable size). For all other devices and file types records are transferred 
directly between the record buffer and the device one record at a time. 


If bit 11 of DCB word 0 is zero and the device is a disk, it is assumed that the 
user takes care of blocking in his own program. 


; Too She oh 
S. popes 3 | 
i Pao ees. 


be x 


DCB Word 3 _ Job number in TRASCII 
0 = current job in global, JOB 
-l1 = system job 
It is used for disk files only. 


DCB Word 4, 5 7 Six-character file name for DIF, DOF, CLI, CLO, MIF, 
MOF. | | 
DCB Word 4 -1 implies the file to be opened is the disk or memory 


working storage. 


Bits 2 to 0. of DCB word 5 must contain the file type if 
the file is a DOF/MOF working storage. 


0 string 

] fixed size data 

2 OBJ 

3 coreimage 

5 variable size data 


| Note 


If the device is a system PID or POD, then no function 
is performed upon open call. The system PID or POD 
is opened at the time of processing SET COMMAND. 
It ean be used by the user but the user is not able 

to physically open or close it. 


Calling Sequence 


ROPEN DATA  40XXXXXXB | 
DATA  RBLBUF BLOCK BUFFER ADDRESS 
DATA n | BLOCK BUFFER SIZE 
DATA _0,0,0 | : 
WOPEN DATA  00XXXXXXB 
DATA  WBLBUF> BLOCK BUFFER ADDRESS 
DATA n BLOCK BUFFER SIZE 


| DATA : 0,0,0 


LDX X1, ROPEN 

BSM* $IOCS 

BRU ~ROERR error return 

: | -normal return 


LDX X1,WOPEN 
BSM* $IOCS | | | 
BRU WOERR  -error return 


-normal return 


Exit Parameter 


For normal return: 


X6 The address of I/O assignment table for this 


device, 


For error return: 


A 


2 


register error code. 


An invalid device code specified or device not 
available (no interface) 

An invalid funetion code specified 

Parity error during disk directory read or OPEN 
call to DP system . 

File not found for DIF, DOF, MIF, MOF 
Device busy 

Insufficient block size or memory space 

No write ring on magnetic tape 

CLIO error 

I/O table overflow 

Working storage already in use 

MACTAB overflow for MOF 


4,4 READ/WRITE RECORD 


Purpose 


Description 


Entry Parameter 


DCB Word 0 


For read 


23 18 


To initiate a read or write a record 


If the device is a ecard reader or a magnetic tape, 


$I1OCS initiates a DMA record transfer. If the device 
is a TTK,TTP,CLI, or CLO, $IOCS initiates reeord 
transfer in character-by-character interrupt mode. If 
the device is a disk, tape, or memory and the block 
buffer is provided, $IOCS transfers a record between 
the reeord buffer and the block buffer. If the block 
buffer is full for output, $I[0CS moves the block to the 
disk; if the block is empty for input, $IOCS reads the 
bloek from the disk. If the block buffer is not pro- 


vided, $IOCS initiates DMA transfer directly between 


disk and the user's read or write buffer. If the 
read/write is requested as ASCII-control-character 
mode, data characters (40B-137B) obtained are echoed 


_and packed into buffer in TRASCII. A control 


character is placed right justified into the last word of 
buffer + 1 and $IOCS exits to the caller. A prompting 
character (may be used to echo the previous character 
read) is output before read, if provided. Trailing 
blanks are not output. 


X6 The address of I/O assignment table obtained 
from OPEN. 


X1 The address of three-word DCB. 


14 13 12 11 10 8 0 


Ge ST 


For write 


23 18 14 13 12 0 


Where R = Return type 


1 Immediate return after initiating I/O 
or placing in the pending list. 


0 Wait for I/O completion. 
When the request is activated or placed in the pending list, bit 23 of the first 
word of I/O assignment table for the request is set to 1, indicating it is busy. 


When the requested function is completed, it is cleared to zero. 


C=0 Normal mode 
1 ASCII eontrol character mode 


M=1 Monitor command read only 
0 All others 
ST -Strobed download from communication 
link (ST bit must also be set on the open 
call) | 
P A prompting character in ASCII code 
DCB Word 1 Starting address of record buffer 
DCB Word 2 Reeord size (the number of words to be transferred), 


the character count for WRITE ASCII control mode 


Calling Sequence 


RDCB DATA 410XXX00B 
DATA INBUF 
DATA n RECORD SIZE 
WDCB DATA 01000000B 
DATA OUTBUF 
DATA n NO. OF WORDS TO WRITE 


LDX*  X6,IOTPI 
LDX X1,RDCB 
BSM* — $I1OCS 
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BRU RDERR error return 
~~ normal return 


LDX* X6,IOTPO 


LDX X1,WDCB 

BSM* $IOCS 

BRU WRERR error return 

-- normal return 
Exit Parameters For error return: 


A register error code 


end of input file 

device off-line 

parity error 

unrecoverable hardware error 

device busy 

invalid I/O assignment address 
file overflow for DOF or MOF 
excess word count on read 


Woon - NO eH 


— 


For error 13, the E register contains the actual num- 
ber of words read. Error 13 takes normal return 
rather than error return. 


4.5 TERMINATE I/O—CLEAR SCREEN 
Purpose | | - To terminate currently active I/O on TTK/TTP 
Description $IOCS clears the channel if the device is TTK or CLI. 


If the device is VKT sereen, the screen is cleared. 
Entry Parameters X6 The address of I/O assignment table or 0. If it 
is zero, the device must be specified in the 
parameter word l. 
X1 The address of one word DCB 


DCB word 0 


For input 


23 18 14 13 12 0 


For output 


23 18 14 13 12 0 


Where D device code 
0 device specified by X6 
1 TTK/TTP 
6 CLI 
7 VK2/VP2 
R return type 


(See description in paragraph 4.4 READ/WRITE RECORD) 
Calling Sequence 


KILLIN DATA 42XX0000B 
KILLOUT DATA 02XX0000B 


LDX*  X6,IOTPI 


LDX X1, KILLIN 
BSM* $1OCS 


BRU ERROR error return 
-- normal return 
LDX* X6,IOTPO 


LDX X1,KILLOUT 

BSM* $IOCS 

BRU ERROR error return 

_—~ normal return 
Exit Parameters For error return: 


A register error code 


device off-line 

unreeoverable hardware error 
device busy 

invalid I/O assignment table address 


com O&O DO 


4.6 TOP OF FORM 
Purpose To advance to top-of-form on line printer 


Description This funetion is performed to the line printer only. If 
other devices are specified, it is a NOP. 


Entry Parameter X6 Address of I/O assignment table 
X1 Address of one word DCB 
DCB Word 0 
23 18 14 13 | 0 


Where D Device eode 
0 Device specified by X6 
4 LP , 


R Return type (See paragraph 4.4 
READ/WRITE RECORD for description) 


Calling Sequence: 


TOF DATA OSXXXXXXB 


LDX* X6,IOTPO 
LDX X1,TOF 
BSM* $IOCS 
NOP 7 ignore error return 
-- normal return 
Exit Parameters For error return: 


A register error code 
2 device off-line 


7 device busy 
8 invalid I/O assignment table address 
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4.7 UNFORMATTED ALPHA WRITE 


Purpose To initiate a write ASCII operation without trailing 
earriage return and line feed 


Description This funetion is used to write a message and wait for 
a response in the same line; for example, PIN NUM- 
BER = response entered here. Therefore, this function 
is provided to TTP only. 


Entry Parameters X6 The address of I/O assignment table 
X1 The address of three-word DCB 

DCB Word 0 

23 18 14 13 0 


Where R Return type (see paragraph 4.4 READ/WRITE 


RECORD for description) 
DCB Word 1 Starting address of the output buffer 


DCB Word2 | Record size (the number of words to be output) 
Calling Sequence | 


WNCRLF DATA 040 X0000B 


DATA WRBUF BUFFER ADDR 

DATA n RECORD SIZE 

LDX* X6 ,IOTPO 

LDX Xl, WNCRLF 

BSM* $10CS 

BRU ERROR error return 

-- normal return 
Exit Parameter For error return: 


A register error code 


7 device busy 
8 invalid I/O assignment table address 
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4.8 .  $KIP A FILE MARK ON MAGNETIC TAPE 


Purpose To skip past an EOF mark on the tape. 

Description The tape is moved until an EOF mark is skipped 
over. 

Entry Parameters - -X6 The address of I/O assignment table or zero if 


the device is specified in the DCB 
X1 The address of one word DCB 


DCB Word 0 


23 18 14 13 12 1 


Where D Device code 
0 device specified by X6 
2 MTRI 
3 MTR2 


R Return type (see paragraph 4.4 
READ/WRITE RECORD for description) 


N 0 skip forward 
1 skip backward 


Calling Sequence: 


SKIPF DATA  45XX000XB 
LDX* X6 ,IOTPI 
LDX X1,SKIPF 
BSM* $IOCS 
BRU ERROR. error return 
=e | normal return 
Exit Parameters For error return: : 


A register error code 
2 device off-line 


7 device busy 
8 invalid I/O assignment table address 
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4.9 | WRITE EOF MARK ON MAGNETIC TAPE 
Purpose To write a file terminator mark on a tape 
Entry Parameter X1 Address of one-word DCB 


X6 Address of I/O assignment table or 0 for 
device override 


23 18 14 13 12 


Where D device code 
0 device specified by X6 
2 MTW1 
3 MTW2 


R __ Return type (See paragraph 4.4 
READ/WRITE RECORD for description) 


Calling Sequence 


EOFDCB DATA 07XX0000B 


LDX X1,EOFDCB 

BSM* = $IOCS | 

BRU ERROR error return 

-- normal return 
Exit Parameter None for normal return 


For error return: 
A register error code 


device off-line 

device busy 

invalid I/O assignment table address 
write ring 


— 
So On DO 


4.10 STATUS CHECK REQUEST 
Purpose To cheek the status of a device 


Description | | $1OCS issues a status read to the device and returns 
the status word. 


Entry Parameter | X1 Address of one-word DCB 
X6 Address of I/O assignment table for 0 for 
device override 


DCB Word 0 


Where: D Device code 

device specified by X6 
MTR1/MTW1 
MTR2/MTW2 

DIF /DOF 

CLI/CLO 


Oo od NY & 


Calling Sequence 


STDCB DATA 10XX0000B 
LDX X1,STDCB 
BSM* $1OCS 
BRU ERROR error return 
-— normal return 
Exit Parameter For normal return: 


A register status word 
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Status Word Description: 


16 
17 


Magnetic Tape Status 


Device ready 
Interrupt in process 
Interrupt enabled 
Interrupt pending 


Rewinding 
No write enable ring 


Memory protect 
Switch on 

BOT 

Low density 

Tape mark has passed 
Data overflow 

DCB error 


Rewind ended 

Word count record 
Length 

Word count record 
Length 

Longitudinal parity 
Error 

Vertical parity error 
EOT has passed 


Disk Status 


Disk not ready 

Parity error 

Interrupt enabled 
Interrupt not manually 
inhibited 

Memory not manually 
inhibited 

Maintenance segment 
addressable 

Data overflow/memory 
Protect on 

Track address overflow 
DCB error 

Interrupt in process 
Segment not found 
Write not manually 
inhibited 

Write not inhibited 
DCU in error state 


For error return: 


A register error code 


7 device busy 
8 invalid I/O assignment table address 
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4.11 | VERIFY/READ 


Purpose To read a record without data transfer to memory 
for verification : 


Description This function is provided to magnetic tape and disk 
only. 

Entry Parameter X1 Address of two-word DCB 

| X6 Address of I/O assignment table 

DCB Word 0 

23 18 14 13 0 


R Return type (see paragraph 4.4 
READ/WRITE RECORD for description) 


DCB Word 1 Buffer address 
DCB Word 2 Reeord word count 
Calling Sequence 


VERDCB DATA 210X0000B 
DATA RBUF 


DATA 512 

LDX X1,VRDCB 

BSM * $I0CS 

BRU ERROR error return 

-- normal return 
Exit Parameter: For error return: 


A register error code 


end of file 

device not available 

parity error 

device busy 

invalid I/O assignment table address 


on > De 
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4.12 CLOSE A FILE 
Purpose To release the device usage 


Description Causes the entry in the I/O assignment table to be 
released. When IJ is equal to zero, the following actions 
are also taken. 


If the device is a MTW1 or MTW2, two end-of-file 
marks (one for file end, one for tape end) are written 
and the tape is repositioned backward so that the next 
file overrides the tape-end mark if written. If the 
device is a DOF or MOF, the block buffer, if any, is 
output to disk or memory and the directory is updated 
with the current size. If the device is a CLI or CLO, a 
CLOSE call is issued. If the device is a TTK, TTP, 

CR, LP, MTR1, MTR2, MIF, or DIF, no other function is 
performed. 


Entry Parameters — X6 The address of I/O assignment table 
X1 The address of one-word DCB 


DCB Word 0 


Where | I 1 input 
0 output 


R Return type (see paragraph 4.4 
READ/WRITE RECORD description) 


C CLO OPTION 
0 hold CLO 
l purge CLO 
2 process CLO 
Calling Sequence 


RCLOSE DATA 92000000B 


LDX X6,IOTPI 
LDX X1,RCLOSE 
BSM* — $IOCS 


BRU ERROR error return 
-- normal return 
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Exit Parameters For error return: 
A register error code 
4 _ parity error 


7 device busy 
8 invalid I/O assignment table address 


4.13 OPERATOR MESSAGE 
Purpose To display a message at the Integrator VKT 
Description _ Allows transfer of a message from the local VKT to 


the Integrator VKT 


DCB Word 0 


23 18 14 13 12 0 


DCB Word 1 Address of the message buffer 
DCB Word 2 Number of words to output 
Calling Sequence 


OPMDCB DATA 14300000B, MSAGBUF,n 


LDX X1,0PMDCB 

BSM* $1OCS | error return — 

-- normal return 
Exit Parameters For error return: 


A register error code 


6 unreeoverable CLIO error 
7 device busy | 
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4.14 DISCONNECT CLIO 
Purpose To disconnect communication link 


Description Used to disconnect the linkage to Integrator. Upon 
next open, the line is connected again. 


Entry Parameters X1 Address of one-word DCB 
DCB Word 0 
23 18 14 13 12 0 


15 


Pope OTT ou nO Te ye 


Calling Sequence 
HNGDCB DATA 15300000B 
LDX X1,HNGDCB 
BSM* $1O0CS 
as error return 
== normal return 
Exit Parameters For error return: 
A register error code 
6 unrecoverable CLIO error 
7 device busy 


4.15 FILE TRANSMIT (ADD) 


Purpose To initiate up-load of data to be appended to the 
file at the Integrator 


Description This function is reserved for $IOCS internal use. It is 
internally generated by $IOCS initializer when an open 
output add is issued to $IOCS. 


Entry Parameters X6 Address of I/O assignment table 
X1 Address of three-word DCB 


DCB Word 0 


23 18 14 13 12 0 


03 


DCB Word 1 The address of the 10-word file identification 
word 0,1 file name, file type 
2,3,4 lot number or zero 
5,6 device number or zero 
7,8,9 category or zero 
DCB Word 2 The number of words to output = 10 


Calling Sequence 
FTADCB DATA 03000000B,CLIOID, 10 


LDX*  X6,CSX6 


LDX X1,FTADCB 
 BSM fIOCS 
-- : error return 
-- normal return 
Exit Parameters For error return: | 


A register error code 


4 parity error 
6 unrecoverable CLIO error 
7 device busy 


4.16 FILE TRANSMIT (CREATE) 

Purpose To initiate up-load of data and create a file at the 
Integrator _ 

Description | This funetion is reserved for $IOCS internal use. It 


is generated internally by $IOCS initializer when an 
open output is issued to $IOCS. 


Entry Parameters X6 Address of I/O assignment table — 
X1 Address of three-word DCB 
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“a 


DCB Word 0 


23 18 14 13 12 | 0 


DCB Word 1 The address of the 10-word file identification 
word 0,1 file name, file type 
2,3,4 lot number or zero 
9,6 device number or zero 
7,8,9 category or zero 
DCB Word 2 The number of words to output = 10 
Calling Sequence 
FTDCB DATA 04000000B, CLIOID, 10 
LDX* X6,CSX6 
LDX X1,FTDCB 
BSM $10CS 
ae error return 
aie | normal return 
Exit Parameters For error return: 


A register error code 


4 parity error 

> duplicate file 

6 unrecoverable CLIO error 

7 device busy 
4.17 FILE END INPUT. 
Purpose To close input file due to EOF at the Integrator 
Description This funetion is reserved for $IOCS internal use. It is 


generated by $IOCS initializer when a close input is 
issued to $IOCS. 


Entry Parameters - -X6 Address of I/O assignment table 
X1 Address of one-word DCB 


DCB Word 0 | | | . 


23 18 14 13 12 0 


Calling Sequence 
| FEIDCB DATA  5000000B 


LDX*  X6,CSX6 


LDX X1,FEIDCB 
BSM $IOCS | 
-- error return 
-- normal return 
Exit Parameters For error return: 


A register error code 

4 parity error 

6 unrecoverable CLIO error 
7 device busy 


4.18 FILE END OUTPUT (PROCESS) 


Purpose To close an output file at the Integrator and allow 
immediate processing. 


Description This funetion is reserved for $IOCS internal use. It is 
internally generated by $IOCS initializer when a close 
output is issued to $IOCS. 


Entry Parameters X6 Address of I/O assignment table 
X1 Address of one-word DCB 
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DCB Word 0 


23 18 14 13 12 0 


Calling Sequence 


FEDCB DATA 06000000B 
LDX* X6,CSX6 
LDX X1,F EDCB 
BSM $IOCS 
-- error return 
-— normal return 
Exit Parameters For error return: 


A register error code 


4 parity error 
6 unrecoverable CLIO erro 
7 device busy | 


4.19 FILE END OUTPUT (PURGE) 
Purpose To purge an output file at the Integrator 
Deseription This funetion is reserved for $IOCS internal use. It is 


generated by $IOCS initializer when a purge-open is 
issued to $IOCS. 


Entry Parameters X6 Address of I/O assignment table 
X1 Address of three-word DCB 
DCB Word 0 
23 18 14 13 12 0 


ade Meo Ae Aes ae ae de Mestd lc es 


DCB Word 1 


DCB Word 2 


Calling Sequence 


The address of 10-word file identification 


word 0,1 file name, file type 
2,3,4 lot number or zero 
5,6 device number or zero 
7,8,9 category or zero 


The number of words to output = 10 


FEPDCB DATA 07000000B, CLIOID, 10 
LDX* X6,CSX6 
LDX X1,FEPDCB 
BSM $IOCS 
-- error return 
-- 7 normal return 
4.20 FILE END OUTPUT (HOLD) 
Purpose To close an output file and hold for later processing at 
the Integrator 
Description This function is reserved for $IOCS internal use. It is 


Entry Parameters 


DCB Word 0 


23 18 


generated by $IOCS initializer when a close output 
and hold is issued to $IOCS. 


X6 Address of I/O assignment table 
X1 Address of one-word DCB 


14 13 12 0 


Calling Sequence 


FEHDCB 


Exit Parameters 


DATA 11000000B 


LDX* X6,CSX6 

LDX X1,FEHDCB 

BSM $I1OCS 

-- error return 
-— normal return 


For error return: 


A register error code 


4 parity error 

5 file name error 

6 unrecoverable CLIO error 

7 device busy 
4.21 FILE REQUEST 
Purpose To initiate download of a file from the Integrator 
Description | This function is reserved for $IOCS internal use. It is 


Entry Parameters 


DCB Word 0 


internally generated by $IOCS initializer when an open 
input to CLI is issued to $IOCS. 


X6 Address of I/O assignment table 
X1 Address of three-word DCB 


DCB Word 1 


DCB Word 2 


The address of the 10-word file identification 


word 0,1 file name, file type 
2,3,4 lot number or zero 
5,6 device number or zero 
7,8,9 category 


The number of words to output = 10 
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Calling Sequence 


FRDCB DATA 53000000B, CLIOID, 10 
LDX* X6,CSX6 
LDX X1, FRDCB 
BSM $IOCS 
-- | error return 
-- | normal return 
Exit Parameters For error return: 


A register error code 


parity error 

file not found 
unrecoverable CLI error 
device busy 


AID oO 


4.22 VKT TRANSMIT 


Purpose To initiate data transmisssion from VKT screen to a 
buffer 


Description It is a special form of read and only applies to TTP. 
| VKT transmit allows reading of the data on the VKT 

sereen from the home position to the last-written data 
position. The buffer must be large enough to store 74 
characters by 27 lines in ASCII (666 words). All char- 
acters except EOT (4B) are transferred to the buffer 
without any conversion (three ASCII characters per 
word). 


Entry Parameters  X6 Address of 1/0 assignment table obtained from open 
° X1 Address of three-word DCB. 


DCB Word 0 


23 18 14 13 12 0 


Where R Return type (see paragraph 4.4 READ/WRITE 
RECORD) 


DCB Word 1 Starting address of record buffer 
DCB Word 2 Record size (number of characters) 


Calling Sequence 


DCB DATA  55010000B, BUF, 1998 
LDX X1,DCB 
BSM* — $IOCS 


BRU ERROR error return 
== normal return 


Exit Parameters For error return only: 
A register error code 


7 device busy 
8 invalid I/O assignment table address 


4.23 SKIP A RECORD ON MAGNETIC TAPE 
Purpose To skip a reeord forward or backward 
Entry Parameters X6 Address of I/O assignment table or zero if the 


device is specified in DCB 
X1 Address of one-word DCB 


DCB Word 0 


23 18 14 13 | ) 


Where D device code 
Q device specified by X6 
2 MTRI 
3 MTR2 


R_ return type 
0 return after completion 
l immediate return 


‘N 0 skip forward 
1 skip backward 
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Calling Sequence 


SKIPR_ . DATA 53000000B 
LDX* X6,IOTP 
LDX X1,SKIPR 
BSM* $SIOCS 
BRU ERROR error return 
-- normal return 


Exit Parameters ~ For error return: 
A register error code 


7 device busy 
8 invalid I/O assignment table 


4.24 PAGE A BLOCK INTO MEMORY 


Purpose To refresh the block of data from the disk or memory 
file at the current position of the file. For operating 
system use only. 


Description This funetion can be used only if the block buffer was 
a _ provided at open time. $IOCS reads in a block from 
the disk or memory starting at the sector/memory 
address which is one block before the current address 
specified in the IOATAB. 


Entry Parameter X6 Address of I/O assignment table 
X1 Address of one-word DCB 
DCB Word 
23 18 14 13 | | 0 


R_ return type ( see paragraph 4.4 
READ/WRITE RECORD for description) 
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Calling Sequence 


RPDCB DATA 54000000B 
LDX* X6,IOPT 
LDX X1,RPDCB 
BSM* $IOCS 
BRU ERROR error return 
-- normal return 
Exit Parameters For error return: 


A register error code 


4 parity error 
7 device busy 
8 invalid I/O assignment table 


4.25 REWIND MAGNETIC TAPE 
Purpose To rewind a tape to BOT position 
Entry Parameter X6 Address of I/O assignment table or 0 for 


device override 
X1 Address of one-word DCB 


DCB Word 


23 18 14 13 0 


D device code 
0 device specified by X6 
2 MTW1 
3 MTW2 


R_ return type 


Calling Sequence 


DCB DATA 06XX0000B 
LDX X1,DCB 
BSM* $IOCS 
BRU ERROR error return 
-- | normal return 
Exit Parameters For error return: 


A register error code 


2 device off line 
7 device busy 
8 invalid I/O assignment table 


4.26 MASTR $IOCS ASCII CONTROL MODE I/O 
l. Read 


Uses the same DCB word 0 as normal read with bit 12 of DCB word 0 set to 
1 (see paragraph 4.4). The record buffer must be defined as the maximum 
allowed input words plus one. All data characters, (40g and 137g) are stored 
into the buffer in TRASCTII (four characters per word). As soon as a control 
character appears, it is placed in ASCII right justified into the last word of 
the buffer and $IOCS returns to the caller. 


Caller's Buffer 


Word O Word 1 Last Word Last Word+1 


Y = data characters in TRASCI 
X = eontrol characters in ASCII 


The number of characters obtained, excluding the control character, is 
returned in the A register. 


2. Write 
Uses the same DCB word 0 as normal write with bit 12 of DCB word 0 set to 
1 (see paragraph 4.4). Characters to be written must be stored in ASCII 


(three characters per word) left justified. DCB word 3 contains the number 
of characters to be written. | 
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MASTR File Description 


Del MASTR SYSTEM FILES 


MASTR system files are created, saved, and transferred to and from the disk, 
magnetic tapes, the disk at the Integrator, and in memory. MASTR maintains all 
files in defined format. The physical formats are defined by the peripheral re- 
quirements and described in paragraph 5.2 through 5.5. The logical formats of 
files are defined by MASTR and described in paragraphs 5.6 through 5.10. 


D2 DISK FILES AND USAGE 


5.2.1 Disk Specification 


200 tracks in Burroughs disk 
192 tracks in Alpha Data disk 


80 seetors/traeck 
48 words/sector 


Do2o2 Disk Organization 


The disk is physically divided into five sections (figure 5-1). The coreimage 
buffer is used by DOPSY; $ARR is the DOPSY monitor and is booted into memory 
when the MASTR command DOPSY is entered. 


The disk files are identified in the disk directory. The information of each file is 
stored in a six-word directory entry (figure 5-2). There are 640 file entry spaces 
reserved on disk (80 sectors). 


The file area contains the actual file data in consecutive order, as specified in the 
directory. The directory does not contain any pointer to a file; to locate the 
starting sector address of a file, the sum of assigned sector numbers of the 
preceding files must be added to the starting address of the file area. 


The unused portion of the disk is called working storage, which can be used to 
assign a file space or to create a new file. 


| 


Core Image Buffer 


171 
$ARR 
178 
File Directory 
258 


System Files and User Files 


Working Storage 


Figure 5-1 Disk Organization 
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8K Buffer 


80 Sectors 48 Words/Sector 
3 80 Sectors/Track 


Burroughs Disk 
200 Tracks 


Alpha Data Disk 
192 Tracks 


Remaining disk space is working storage. 


16000 (Burroughs) 
15320 (Alpha Data) 


Word 


) 


Job Number 
Number of Words Used 
Load Address 
Number of Sector Allocated Record Size 


Bit Description 
23 to 0 First four characters of file name (TRASCII) 


23 to 12 Last two characters of file name (TRASCII) 
ll to 4 Not used 
3 tol File type 
000 string 
001 data (fixed length) 
010 object 
011 coreimage 
101 data (variable length) 
0 = 1 last entry in the directory 


23 to 0 Four-character job number (TRASCI) of the file 
23 to 0 Number of words used by the file (file size) 


23 to 10 Number of sectors allocated for the file 

9 to 0 File type 011 only - first 10 bits of address 
(loading point of program) 

9 to 0 File type 001 only - record size 


23 to 20 Last four bits of address (load point) 


(File Type) 19 to 16 Not used 


O11 only 


15 to 2 Entry point of program 
1 to 0 Interrupt sector count used 


Figure 5-2. Disk Directory Entry (Six Words per File) 
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5.2.3 Disk File Format 


On disk, five different file types are maintained: string files, variable data files, 
fixed data files, coreimage files and object files. DOPSY does not generate or 
recognize variable length data files and treats all data files as if they are fixed. 


All files on disk are placed continguously without any physical reeord or file 
terminators. An end of a file is identified by the number of words in the file, 
which can be obtained in the directory entry. A record ean be identified based on 
the file type. 


A string file record for the disk is described in paragraph 5.6 and it is identical to 
ones on other media. 


Coreimage file format is described in paragraph 5.9. In DOPSY, coreimage files 
are not transferable. 


Five different record formats for object files are described in paragraph 5.10. 
5.3 MAGNETIC TAPE FILES AND USAGE 


3.3.1 Tape Organization 


A physical record is data terminated by a record mark. Skipping a record forward 
or backward is done on this physical record. The size of one physical record is 
determined by the program which generates the record onto a tape. 


A logical record is defined based on the file type. Normally, there are several © 
logical reeords in a physical record. 


A file is a set of physical records terminated by a tape mark. Skipping a file 
forward or backward uses this tape mark for positioning. The tape mark is 
normally written at the file closing time. Datalogging to a magnetic tape or 
FACTOR writing to a magnetic tape aiways causes a tape mark to be written 
immediately after a physical record and repositioned back. If another record is 
written, the tape mark is erased over; otherwise, the tape mark is there even if 
the file is never closed. 


An end of a logical tape (an end of valid data area) is identified by having a tape 
mark without a file. $IOCS always writes two tape marks at the file closing time 
and backs up one tape mark in ease another file is written. Therefore, all closed 
tapes always have an end of a logical tape. 


Deded Blocked File Format Generated by DUMP and COPY Programs 
File types handled by DUMP and COPY are identical to those on disk; string, 


variable and fixed size data, coreimage and object files. Record formats for 
these files are described in paragraphs 5.6 through 5.10 and shown in figure 5-3. 


Physical Record 


Header is identical to six-word disk directory 
(Figure 4-2) except that the last word contains 
ROBT” for all file types except coreimage. 


Six-Word Header 


Record Mark 


960-Word Block 


Record Mark 


Logical records are blocked into 960-word 
physical record. 


960-Word Block 


Record Mark 


A logical record may cross between two 
_ physical records. 


1-960-Word Block The last block may be 1-960 word remaining data. 


Record Mark 
| Tape Mark 


This format ean be read by LOAD, COPY or DOPSY BMT programs. 


Figure 5-3 A Blocked File 
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5.3.03 TDX-Generated Magnetic Tape 
During TDX INIT, a terminator record is generated (figure 5-4). 


TDX MAKE generates multiple directories (figure 5-5). Each directory contains a 
directory header (figure 5-6) followed by multiple files (figure 5-5). 


TDX program causes COPY program to generate files as described in paragraph 5.3.2. 


This tape format can be read by LOAD, MASTR TDX and DOPSY TDX. 


Record 1 | 
END — TDX | TAPE 


Figure 5-4 Terminator Format 


Generated by TDX 
(Figure 5-6) 


Directory Header 


Tape Mark 


Directory Header 


| Tape Mark 


Directory Header 


Tape Mark 


Tape Mark 
Tape Mark 


Generated by COPY 


Directory 1 (Figure 5-3) 


Generated by COPY 


Directory 2 


Directory n 


Figure 5-4 


Figure 5-5 TDX Tape Format 


on 


| 7th word contains n in 
THIS TDX | TRASCII right justitied 
NTAIN S n = number of files in 


ES. B oe directory + 1 


Record 


(REV 2 


4th word contains m in 
TRASCII left justified 
t = file type (S,O,D,) 
xx = checksum 


Any combination or job, 
verify and comment 
appear in records 3-(k-1) 


The last record in tape 
directory is always //set 


Figure 5-6 TDX Directory Header Format 


5.3.4 - MBUP Tape Format 


The purpose of the MBUP tape is to save the contents of memory on magnetic 
tape (figure 5-7). MBUP transfers the bootstrap loader and the operating system 
from memory to magnetic tape. It then calls DUMP to output the remaining 
files. 


This tape can be read by the MBUP overlay or LOAD program. If the first two 
files (the boot and the operating system) are skipped, the remaining files can be 
read by the COPY overlay or DOPSY BMT. 
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File 1 


File 2 


File 3 


File 4 


File m 


Figure 5-7 


Bootstrap 


Tape Mark 


Record Mark 


MASTR Operating System 
Blocked in 960-Word Records 


Record Mark 


Tape Mark 


File 


Tape Mark 


MBUP Tape Format 


Generated by DUMP (Figure 5-3) 


Generated by DUMP 


Generated by DUMP 


3.4 FILES TRANSFERRED TO THE INTEGRATOR 


5.4.1 Reeord Description 


The maximum size of a record is 124 characters for a string record and 40 words 
for a binary record. Either record is appended with an eight-character record 
header before transmitting to the Integrator. The header is stripped off by the 
driver when it is sent from the Integrator. A leading protocol character, STX, 
and trailing protocol characters, ETC and LRC, also are appended or stripped by 
the driver. 


0 1 8 n n+1 | n+2 


Characters 


Character Record Format 
STX 0 Start transmission 
Header 1 _——«FST system code = ASCII 0 
2 Sub addr = Station 1, 2, 3, 4 in 
ASCII or ASCII 8 for background 
3 Destination code = ASCII 0 
4 Sub addr = same as word 2 
) Character count for binary record 


(3 per word), 0 for string record 


6 Message type 

7 Spare 

8 Spare 
Record Data n Data 
ETC n+] End of transmission 
LRC n+2 Cheeksum 


5.4.2 CLI/CLO Blocked Binary Files 


Files transferred to and from the Integrator by programs LOAD or DUMP are 
in blocked binary format. All file types described in paragraphs 5.6 through 
5.10 can be transferred in the format shown in figure 5-8. 


Six-Word File Header 
Data Record 1 
Data Record 2 


Figure 5-8 | CLI/CLO Blocked File Format 


Same as disk directory 
entry (see figure 4-2). 


Data records are blocked 
in 40 words. 


The last record may be <40 words. 


5.4.3 CLI/CLO Unblocked String Files 
Files transferred to and from the Integrator by the program COPY are unblocked 


and contain variable-length string records. Only the string files (paragraph 5.6) 
ean be transferred in the format shown in figure 5-9. 


Figure 5-9 CLI/CLO Unblocked File Format 
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4.4 CLI/CLO Variable Length Data File 
The files CLO or DATALOG to CLO are created by FACTOR WRITE statements 


and contain variable-length data records (See paragraph 5.7 and figure 5-10). The 
record size is limited to 40 words. a 


Figure 5-10 | CLI/CLO Variable Length Data File Format 


on 


20 FILES STORED IN MEMORY 


Since memory has no physical breaks, any file loaded or created in memory re- 
sides contiguously from the starting address to the end address. 


MACTAB is a file directory (figure 5-11) that has information on the files 
currently in memory. There are many more file types in memory than on disk or 
magnetic tape. This is because once a file is loaded into memory, it ean be 
executed or used to test a device. It is desirable to indicate allowed usage to 
minimize operator error. File types indicated for files in memory are subsets of 
file types provided to disk or magnetic tape files. 


They are mapped as follows: 


Type In Type On 

Memory Disk Description 

OVLY COREIMAGE Assembly language program 
executable as an overlay 

TP DATA FACTOR test program 
executable on a 
station or loadable by 
LMLOAD overlay 

MOD DATA FACTOR module program 
eallable or loadable by 
LMLOAD overlay. 

S STRING String /source file 

DATA DATA File written by a FACTOR 
program or by an overlay 

OBJ OBJECT A file generated by Assembler 

U COREIMAGE Coreimage file that is not 

Unde fined an overlay or a working 


storage file that has not been 
assigned as a particular file 
type. 


Formats for these files are described in sections 5.6 through 5.10. Internally, file 
_ types are used by a code which maps with the file type code supplied in the test 
program header (paragraph 5.8) or the overlay header (paragraph 5.9). Refer to 
the system memory map, figure 5-12. 


8 words per entry, 32 entries in table 
Total 256 words. The table is expandable by ASSIGN command. 


MAJOB 
MANAM 
MATYP 
MAMADR 
MAFSIZ 
MAMSIZ 
MAIOPT 


MAWSTR 


23 21 18 15 12 9 6 3 0 


LTT ET TIT TTT TT Tit tt ti rt ttt ty 
Ce 
oe 
ee 
2 A 
rs 
ee 


ee ee ee 


oO 


Figure 5-11 MACTAB (Memory Activity Table) 


Job Number Job number of the file 


NAMEI, NAME2 Six-character file name 


0 = not used, NAME 1 =-1 = Working Storage 


Active IND | File is active when non-zero 


Bit 6 ~=file attached to STAT] 
Bit 7 file attached to STAT2 . 
Bit 8 file attached to STATS 
Bit 9 file attached to STAT4 
Bit 10 overlay currently running 
Bit 11 file is open for I/O : 


Type 


Memory Address 


M (Bit 23) 


K (Bit 22) 


R (Bit 21) 


P (Bit 20) 


File size 


Memory size 


JOATAB pointer 


Window start 


File type code from file header (octal) 
13 to 40 System overlay 


71 Overlay in background, expands, or 
generates memory files. 
12 DATA 
73 OBJ 
74 STRING 
75 Module test plan 
76 Test plan 
77 ALLINK overlay 
0 Undefined 


Starting address of the file in memory 


Indicates that this file is in memory 
NAME 1 = 0 and M = 0 occurs only for PAGE test plan 
which is bumped out of memory 


Keep indicator 

1 The file was loaded with KEEP option or from 
non-disk media 

0 The file was loaded from disk without KEEP 
option 


Pending to be released 


Partial indicator 
0 complete file is in memory 
1 partial test plan due to paging is in memory 


Number of words required to hold the file. 


Number of words in memory actually allocated to the 
file. If greater than file size, file has extra memory 
(expanded). If less, file is foreed to page. If zero, file 
not in memory. : 


Starting disk sector address for test programs loaded 
from disk/IOATAB address for files used as memory files 


Instruction count at the first address of the file area 
for paging test programs. 


Address 0 


Entry / Restart 


Reserved for Interrupt Address 


SYSVAR (System Variables) 


BITFLD (Bits Set) 
NBTFLD (Bits Not Set) 


RTMSK (Mask Set from Right) 


206 
= LFMSK (Mask Set from Left) 


DECFLD 
OCTFLD 
(Octal, Decimal Constants) 


401 | 

pare DBFLD (Double-Bit Fields) 
417} | 

420 


GLOVAR (Global Variables) 


607 
610 


SYXVEC 
(Subroutine Transfer Vectors) 


| Up to this point 
l. cells are fixed 


Figure 5-12 System Memory Map 


Monitor 


Subroutines 
$IOCS and Drivers 


Test Head Driver 
| Test Head Driver Up to here booted from disk or mag tape 


SVT 


Station Variable Table (SVT) 


FWALT 
ALTER Buffer 


TVT 


: Reserved space restored 
Tester Variable Table (TVT) from $GLOBS at return 
from DOPSY 
FWIOA 
IO Assignment Table (LOATAB) 
FWMAC 
Memory Activity Table (MACTAB) | Expandable by 
a Command 
LWSYS 
Test Programs, Overlays, Files 
FWAM 
Available Memory Space Dynamic Allocation Area 


LWAM 
Run Time Stack 


High Address LWCPU 


Figure 5-12 | System Memory Map (Continued) 
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5.6 STRING FILES 


String files may be an assembly language source, a FACTOR test program source, 
a command file, or any file containing TRASCII data. 


A string record contains 0 to |32 TRASCII characters terminated by 77B (a 
backarrow character). 


The terminator 77B is always right justified in the last word of a record. The 


record may contain up to three blank characters. All other trailing blanks are 
eliminated. 


String File 


: 2 
D7 VARIABLE LENGTH RECORD DATA FILES 


Data files opened by the command OPEN are variable in length and are written by 
FACTOR WRITE statements, datalog in binary format, or by overlays. To bea 
variable record format ean be specified during OPEN procedure and blocking or 
unblocking can be done using the word count in each record. 


a yee fe | General Record Format 


woo fom 


Word 0 contains the following information: 


Bit Description 
0 to ll Reeord length in words, 4096 words maximum 
12 to 17 Record Type. Each datalog record carries a two-digit number that 


specifies the type of record. 
(See table 5-1) 


Bits 12 to 14 specify the particular record type with the class, for 
example, de measurement, voltage mode or failure 


Bits 15 to 17 specify a record class, such as 


DCMEAS 
18 to 21 Spare, not used. 
22 ] User-defined reeord 


0 System-defined record 


23 1 Format reeord 
0 DATA record 


A data reeord from the datalogger with two items would appear as: 


967.2 File Format for Variable Length Data 


The disk, memory, or magnetic tape files generated by DATALOG or FACTOR 
WRITE statements contain a header record that is generated during OPEN output. 
Since it is skipped over during open input, the FACTOR test program does not see 
this record. If an overlay is written to read this file, it must handle this record. If 
an overlay generates a file to be read by a FACTOR program, this record must be 
generated. File formats are shown in figure 5-13. 


File on Disk or Memory 


| Header Record | 
Data Record 1- 
Data Record 2 


Data Record n 


File on Integrator 


Data Record 1 | 


: | : Data Record 2 


Figure 5-13 


File on Magnetic Tape 


Header Record | 
Record Mark | 


Data Record 1 
Record Mark 


Data Record 2 


| Record Mark 


[Data Record 
Record Mark i 
Tape Mark 


File Formats For Variable Length Data 
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5.7.3 Header Reeord Format 


The header record (figure 5-14) is prepared at the time of opening an output by 
requesting log, device, and category information. This data is required at the 
Integrator in order to sort the data properly. They are sent to the Integrator as 
part of the file identification for opening the file, but are stored as the first re- 
eord for all other media. | 


Each item is left justified in each position of words provided. 


a 
File Name (First 4 Characters) 


Lot Number (12 Characters) 


Device Number (8 Characters) 


11 Category (12 Characters) 


12 


Figure 5-14 Header Record 


0.7.4 '_ Datalog Reeord Formats 
Measurements are sent as FST 24-bit floating point numbers. Records with ASCII 
information are sent with four 6-bit TRASCII characters per word. Integer and 


central information varies depending on the record. See each record description 
for specific format (table 5-1). 


Table 5-1 §Reeord ID For Datalog Reeords 


Reeord ID 


Number Record Is From | 

00 Open header record 

01 DPS voltage trip 

02 DPS current trip 

10 Direet current fail - current force mode 
1] Direct current fail - voltage foree mode 
12 Direet current pass - current foree mode 
13 | Direct current pass - voltage foree mode 
14 | Measure variable | 

20 | Functional failure 

21 . PPM memory fail 

22 | PPM memory fail, data extension 

23 Functional failure, messages 

30 EOT record 

31 Device header 

40 Shmoo plot 

50 | Data I/O 


5.7.4.1 DPS TRIP FAIL RECORD 


The DPS trip fail reeord (figure 5-15) is generated when DATALOG TRIP is re- 
quested and a power Supply trip occurs. 


Each power supply trip is written as a separate record. 


Word @) 


CC ce 


Word Description 


0 Reeord ID=02 Current TRIP 
ReeordID=01 =~ Voltage TRIP 
Record length = 7 FST words 


] Instruction number = 16-bit unsigned integer 
2 Test type = 16-bit unsigned integer 
3 Module number = 16-bit unsigned integer 

4 Trip supply number = 16-bit unsigned integer 
) GT/LT = TRASCI LT or GT 

6 Trip value = 24-bit floating point number 


Figure 5-15 DPS Trip Fail Record Format 
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DIRECT CURRENT FAIL RECORD 


The direct current fail record (figure 5-16) is generated when DATALOG DCT/ 
MEAS/LOG is requested and the measurement fails. | 


Word 


Word 


worn oP WN Fe 


23 21 18 15 12 9 6 3 0 


Ce ee a. 


Description 


Record ID = 10 current forece/voltage measure mode 
Record ID = 11 voltage forece/eurrent measure mode 
Record length = 9 FST words . 

Instruction number 

Test type = 16-bit unsigned integer 

Module number = 16-bit unsigned integer 

Pin number | 

Flag word - ASCII fontiatting information - cell SMF of SUT table 
Measured value = 24-bit floating point number 

DCTO = 24-bit floating point number 

DCT1 = 24-bit floating number 


Figure 5-16 Direct Current Fail Record Format 
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9.74.3 DIRECT CURRENT PASS RECORD 


The de PASS record (figure 5-17) is generated when the DATALOG MEASURE/LOG 
is requested and the de measurement passes. 


Word 0 


a ce 


RECORD ID = 12 Current mode 
13 Voltage mode 
14 Measure variable 


Remaining record fields are the same as a de fail record, (figure 5-16) 


Figure 5-17 Direct Current Pass Record Format 
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9.7.4.4 FUNCTIONAL FAILURE RECORD 


The functional failure record (figure 5-18) is generated when DATALOG FCT is 
requested and a functional failure occurs. 


fe 
oe 
@ | 


Figure 5-18 Functional Failure Record Format 
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Word Description 


0 Record ID = 20 3 
Record length = 14 to 22 words (depends on number of ranks used) 
Instruction number = 16-bit integer 
Test type = 16-bit integer 

Module number = 16-bit integer 

Local memory location = 12-bit integer 
Test sequence count = 24-bit integer 


O71 em WwW DO 


The C and F register data is contained in bits 0 to 14. 


Figure 5-18 Functional Failure Record Format (Continued) 
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5.7.4.5 FUNCTIONAL FAILURE RECORD FAIL MESSAGE 


The functional failure record fail message (figure 5-19) is generated for de 
timeout, loop count or clock burst count failure. 


— 23 21 18 15 12 9 6 3 0) 


- TRASCII Message 


Figure 5-19 Functional Failure Record Fail Message Format 


Word Description 


0 Record ID = 23 
Record length = 9 FST words 
l Instruction number = 16-bit integer 
2 Test type = 16-bit integer 
3 Module number = 16-bit integer 
4 Local memory location = 12-bit integer 
D Test sequence count = 24-bit integer 
6 to 9 TRASCII messages are: 


T/O, FC 
T/O, LOOP 


Each message is three words, with four 6-bit TRASCII characters 
per word. | 


Figure 5-19 Functional Failure Reeord—Fail Message Format (Continued) 


9.7.4.6 PPM MEMORY FUNCTIONAL FAILURE RECORD 


The PPM memory functional failure record (figure 5-20) is generated when a 
function fail in an MUT occurs. 


23 21 18 15 12 9 6 3 0 


Word ~ Description 


0 Record ID = 21 (nondata extension mode) 
Record ID = 22 (data extension mode) 
Record length = 11 words 


4 Test sequence count = 24-bit integer 
9 to 10 C - Register Ranks 3 and 4 contain information for data extension 
| mode only. 


Except for ID and test sequence count, all words are 16-bit integers 


Figure 5-20 PPM Memory Functional Failure Reeord Format 
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Del Abed EOT RECORD 


The EOT record (figure 5-21) is generated when end-of-test point is reached and 
DATALOG EOT is requested. 


Word ofo 


Record ID Record Length 
EIR Data 


Record length = 2 
Reeord ID = 30 


EIR data 

Bit Description 

0 to 9 User defined value 
10 DC test fail 

1] , DC test pass 

12 Functional test fail 
13 Functional test pass 
14 End of test 


Figure 5-21 EOT Record Format 


5.7.5 Writing From A FACTOR Program 


A FACTOR program may cause data to be written by one of the following types 
on statements: 


WRITE "ident" ARRAY; 

WRITE "ident" variable; variable,... 

WRITE "ident" 'TEXT'; 

WRITE "ident" 'TEXT', V1, V2, V3, 'TEXT', V4, V5, V6; 
WRITE "ident" /n/ 'TEXT', variable; 


The first two statements above result in the following format: 


Word 0: 

Record length number of elements in the array plus 1 (4,096 
maximum) or number of variables plus 1 (33 maximum). 

ID TRASCII character in double quotes 

Code 010000 (binary) 

Word 1 ton floating point numbers 


The last three statements involve a combination of binary and TRASCII data and 
may cause more than one record to be generated. 


O-32 


Word 0 has the same format as the first two FACTOR program statements. 


Reeord length number of words in text plus 1 or number of variables plus 1 
(maximum 33 words). 


D8 FIXED LENGTH DATA FILES 


Fixed length data files contain data in words rather than characters. The number 
of words per record can be obtained in the disk directory or file headers (figure 5-2). 
The record length of 18 words is used as default. 


Sr 


RECORD =n +1 words 


Test programs and modules are normally considered fixed-length data files. How- 
ever, these files have additional defined format. The first 18 words are the test 
program header; each word is used according to definition. The FACTOR 
compiler generates this header for test programs and modules. The extended 
FACTOR compiler generates this header for macro modules. LMLOAD overlay 
generates this header for local memory data modules. 


Test Program, Module Header 


Word 0 Reserved 
l First four TRASCII characters of the name 
2 Last two TRASCI characters of the name (left 
justified 
File type: 76B for test programs, 75B for modules 
Release revision number 
Program size (number of words used) 
to 16 Reserved 
7 Contains APM vector table pointer 


rt DO CO 


5.9 | COREIMAGE FILES 


Coreimage files contain data in words. This data may be absolute or relocatable, 
depending on the data and the usage of the file. Programs run under DOPSY are 
absolute coreimage and overlays run under MASTR are relocatable coreimage. 
Normally absolute coreimage files are not transferrable and remain on disk. The 
format of a relocatable coreimage file is identical to the one of an absolute 
ecoreimage file except that it does not use interrupt sectors. 


COREIMAGE FILES (FILE TYPE = 011) 


Coreimage Files (File Type = 011) | 


A 


Interrupt Sectors 


The first three sectors may contain interrupt addresses. The number of sectors 
used for interrupts is specified in the directory word 5 bits 1 to 0. Interrupt sec- 
tors contain two words of information per interrupt. (48 words by 3 sectors/2word = 
72 interrupts per program maximum). 


Program body is already mapped to memory (1 word of data = 1 word of memory 
when loaded). 
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INTERRUPT INFORMATION IN INTERRUPT SECTORS 


Word 


0.9.1 


a 


Bit Description 

13 to 0 Address of interrupt service routine 
23 = 1 last interrupt entry 

2 to 0 Interrupt address of the device 


Overlay Header Format 


A MASTR overlay is a relocatable coreimage file beginning with a 22-word 
overlay header. 


Words 22 to 27 contain information used by the VERIFY overlay to display REL 
and date. 


Table 5-2 deseribes the contents of each of the words that comprise the header. 


Table 5-2 Overlay Header Format 


WORD 


0 0 

] The first four characters of overlay name in TRASCII 
2 The last two characters of overlay name in TRASCII 
3 File type code 

4 Release revision number in TRASCII 

5 File length including header ( words) 

6 Expansion size (words) at load time | 


7 | Reserved for system use 
10 Module relocation value store 
1] Module return address store 
12 PZE for module entry point 
13 BRU for module entry point 
14 PZE for reset/kill entry 
15 BRU for reset/kill process 
16 PZE for special purpose entry 
ie BRU for special purpose entry 
20 | PZE for release overlay entry 
21 BRU for release overlay process 
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Table 5-2 Overlay Header Format (Continued) 


WORD 22 PZE for normal background entry 
23 BRU for normal background entry 
24 PROC for foreground entry 
25 BRU for foreground entry 
26 Number of words in release notes 
27 to 33 Release notes (date) 

5.9.2 File Type Code List 


Table 5-3 shows the file type code list. 


Table 5-3 File Type Code List In Memory 


Code 


0 to 12B 
14B 
15B 
16B 
17B 
20B 
21B 
22B 
23B 


Files 


Undefined 


Manual analysis 


Parameter distribution 
Datalogger 


DEBUG 


Overlay that takes long time to execute 
(EDIT), expands (COMPILE), or generates 
memory files (ASM, COPY) 

Data files 

Object files 

STRING files 

Module test programs 

Test programs 

General overlay 


0-36 


5.10 OBJECT FILES 

Object files are generated by assembler and used by CREATE to generate 
ecoreimage files. An object file contains relocation directives as well as 
executable CPU instructions. 


OBJECT FILE (FILE TYPE = 010) 


Object File (File Type = 010) 


ee ee ne ee 


Variable Size Reeord 
Record: Contains from 2 to 6 words, depending on the record type 


The following format is used for word 0 in all records, except record type 4 
and 5. 


32 (2 18 15 12 9 6 3 
Word 0 | Number of Words — | Relocation Address 
Bit Description 
Word 0 23 to 21 Reeord Type 


0 = START (first object record) 
1 = DATA (Instruction reeord) 


2 = PROC 
3 = CALL 
7 = END 
20 to 15 Number of data words in this record excluding — 


word 0 and word 1 


14 to 0 Reloeation address to which the data words are 
loaded. 
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Record Type = 0 (START) 


Bit | Description 
Word ] 0 0 No ABS directive (software relocatable) 
1 Absolute program (ABS directive) 
i’ 0 No REL directive (not relocatable by 
hardware) 


1 Hardware relocatable (REL directive) 


Record Type = 1 (DATA/INSTRUCTION) 


Bit Description 
Word 1 23 to 0 Instruction in record is relocatable if corresponding 
bit is set. 
Word 2 Word n Contains instruction words. 


Record Type = 2 or 3 (PROC or CALL) 


Bit Description 
Word 1 23 to 0 First four character symbol name (TRASCII) 
Word 2 23 to 12 Last two character symbol name (TRASCII) 


Record types 2 and 3 contain no other data. 


Record Type = 4 (EXT) 


Word 0 


Record 
ab a ee 


Bit Description 
Word 0 23 to 21 Reeord type 
20 D/O data = 1, opcode = 0 
1] to 0 Right half of opeode 
Word 1 23 to 0 First four characters symbol name (TRASCII) 
Word 2 23 to 12 Last two characters symbol name (TRASCI) 
11 to 0 Left half of opeode | 


Record Type = 5 (ENT) 


Word 0 


Record 


Bit Description 
Word 0 23 to 21 Record type 
13 to 0 Relative address of symbol 
Word 1 23 to 0 First four characters symbol name 
Word 2 23 to 12 Last two characters symbol name 
11 to 0 Flags 


Reeord Type = 7 (END) 


Word 1 


Check Sum | : 
Last Record of File 


Bit Description 


Word 1 23 to 0 Checksum of the file excluding type 7 record. 
| Bit 23 is always set to 1. Checksum is obtained 
from summing all words in the file and 
40000000B is ORed at the end. 
Word 2 23 to 0 Contains 77777777B to indicate last record of 
file, 
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Assembly Language Overlays 


6.1 INTRODUCTION 


Assembly language overlays (ALLINK programs) are user-written assembly lan- 
guage programs that are executed either through the EXEC statement of a FAC- 
TOR program or as a background function. Executing ALLINK programs through 
the EXEC statement initiates and performs data collections or manipulations by 
communicating between a FACTOR program and/or provides communications 
between a FACTOR program in foreground and associated background processing. 
Executing assembly language programs as a background function performs I/O 
operations, for example, outputting reports or receiving information from th 
keyboard. : 


ALLINK programs are written in Fairchild Assembly Language for the FST-2 
computer. The instruction set and the assembler are described in the FST-2 
Computer Manual, publication number 57000002. 


6.1.1 Foreground/Background Processing 


Foreground processing refers to Tester-related operations. Thus, the FACTOR 
program and the section of the ALLINK program executed through the EXEC 
statement are referred to as operating in the foreground. 


Background processing refers to non-Tester-related operations which are rela- 
tively slow, such as I/O operation. During foreground processing, there is a cer- 
tain amount of hardware idle time, such as relay switching and power supply 
Settling time. During this idle time, background performs its operation. Thus, 
the slower background operations are performed without affecting test time. 
Obviously, I/O operations in foreground processing would decrease Tester 
throughput significantly. | 


6.1.2 Risks Involved in ALLINK Programs 


ALLINK programs that perform functional or de failure testing have a direct 
effect on the results from system routines such as datalog or DCF. Device fail- 
ure, whether it occurs in a FACTOR test program or an ALLINK program, causes 
the interrupt service to set flags, which are the basis for decisions by system 
routines. Thus, if an ALLINK program does perform this type of testing, the 
results from system routine may be meaningless. 
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Since any ALLINK program executed by the system cannot be completely 
controlled by the system software, any undebugged ALLINK program 
inadvertently may alter the hardware and software and thus, alter or destroy the | 
integrity of the system software. Therefore, it is highly reeommended that 
ALLINK programs be debugged outside of production environments. 


6.2. ALLINK PROGRAM DEFINITION 

The system requires the ALLINK program to have a header. See paragraph 5.9.1 
for a description of the overlay header format. 

6.2.1 ALLINK Header 

The header consists of 27B words at the beginning of the ALLINK program and 
contains the system information for loading and executing the overlay. The 
header must follow the format given in appendix A, and must have an OBJ 7 and 
REL directives in front of the header. There are three program entry points. The 
mode under which the ALLINK program is executed determines which of the 


entry points is used. 


The foreground entry point is used to transfer control from a FACTOR test plan 
(through the EXEC statement) to the foreground section of the overlay. 


The background entry point is used when the monitor receives a program-name 
command for the overlay. 


The release entry point is used when the command: RELEASE is entered to re- 
move the ALLINK program from memory. 


The reset entry point is used when the tester is reset manually (reset pushbutton). 


Example Entry Points: 


RESET PZE 0 RESET ENTRY POINT 
BRU* RESET RETURN IMMEDIATELY 
3 BSS 2 
RELSE PZE 0 RELEASE ENTRY POINT 
BRU* RELSE RETURN IMMEDIATELY 
BGEP PZE 0 BACKGROUND ENTRY POINT 
| BRU BGSTRT GO TO BACKGROUND 
PROCESS ROUTINE 
FGEP PZE 0 FOREGROUND ENTRY POINT 


BRU FGSTRT GO TO FOREGROUND 
~ PROCESS ROUTINE 


This example shows foreground, background, reset, and release entry points with no 


clean-up when the overlay is released (the release is always performed when 
requested). There is no foreground processing in this program. 
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RSENT PZE 0 
BRU#* RSENT 


BSS 2 
RELSE PZE 0 
BRU CLRUP GO TO RELEASE 
: PROCESS ROUTINE 
BGEP PZE 0 
BRU BGSTRT 
FGEP PZE 0 
BRU* FGEP NO FOREGROUND PROCESS 
6.2.2 Creating Relocatable Coreimage 


After an ALLINK program is assembled and an object file is created, a 
relocatable coreimage file can be created with the following command in DOPSY: 


CREATE 'name' 'obj-file-name' 
Rules and Restrictions: 
o REL directive is provided at the beginning of the SOURCE program or REL 
parameter is supplied in the ASM command. 


o The program must be originated at location 0. This will happen by default 
if an ORG directive is not included at the beginning of the program. 


6.3 LOADING AND CALLING PROCEDURES 


6.3.1 Loading Procedure 


Before the ALLINK program can be called by either foreground or background, it 
ean be loaded using the monitor LOAD command. 


Example: 
LOAD 'DBTS' 
This command causes the ALLINK program DBTS to be loaded from disk. 


Once loaded, the program can be called from either foreground or background. If 
the ALLINK program is called by a command or by the EXEC FACTOR state- 
ment, and if it has not been loaded into memory, the system tries to load automat- 
ically. If there is not enough room, a terminal error occurs at EXEC execution 
point. 


6.3.2 _ Calling Procedure 


An ALLINK program is called from the foreground by a FACTOR EXEC state- 
ment. EXEC statements must have the following format: 


EXEC program-name (v],V9,...Vn) 
Where program-name is the name of the ALLINK program in relocatable 
eoreimage form. A maximum of 63 parameters is allowed. Each parameter is 
evaluated at the time of EXEC and may be global variables, user-defined 
variables, array elements, formal parameters or arithmetic expressions, 


Upon entry to the ALLINK program, the index registers contain the following 
information: 


X3 number of parameters passed 
X4 address of Ist parameter -] 
X6 station code -] (i.e. code 0 to 3 = station 1 to 4) 


The FACTOR statements: 


DCL P2 [3]; REM NOTE P2 1S AN ARRAY; 


EXEC XTEST (P1,P2,P3); 


would cause pointers and variables to be mapped as shown: 


Pointer Stack 7 Parameters Array 


Value P1 
Address P2 
Value P3 


x4 


Address of P1 


Address of Address of P2 
Address of P3 


Value P2(0] 
Value P2[1] 
Value p2[2] 
Value P2[3] 


Size of Array 


To obtain and save P1 and P3 use the following instruction sequence: 


LDA* 1,X4 GET 1ST PARAMETER 
STA TEMP1 SAVE IT 
LDA* 3, X4 GET 3RD PARAMETER 
STA TEMP3 SAVE IT 


To obtain element 3 of array P2, use: 


LDA* 2,X4 GET ADDRESS OF ARRAY 
LXA XO MOVE TO X5 
LDA 3, X5 GET 3RD ELEMENT 


If it is known whether a passed parameter is a variable or an array, then the 
determination can be made by checking bit 22 of the word in the pointer stack. 
For example, to check P2 for an array use the following instruction sequence: 


LDA 2, X4 GET P2 POINTER 
CAM B22 IF B22 SET 
BBC ARRAY THEN IT IS AN ARRAY 


To obtain the number of parameters, the instruction 
LAX X3 


is executed. 


6.3.2.2 BACKGROUND CALL 
The background section of ALLINK program ean be entered by the command: 
program-name (input) (output) optional parameters 
where program-name is the name of the ALLINK overlay and the input and output 
devices are optionally assigned to the program. Absence of input/output dvices 
eauses default to the PID/POD for any I/O operations. Allowable input/output 
mnemonics are shown in the Sentry VII Users Manual, publication 57000013. 
Example: 
EXAMPLE LP 
This command would cause the ALLINK program (overlay) named EXAMPLE to be 
executed in the background mode using the line printer as its output device. 
6.3.2.3 RELEASE CALL 


This section of the ALLINK program can be entered by a command: 


RELEASE 'program-name' 


There are three possible release procedures: 


e No release processing is needed. The ALLINK program should return to the 
system immediately as is shown in the first example entry point (see para- 
graph 6.2.1). | 

e Aclean-up process is necessary before release in order to maintain system/ 
user program integrity. The entry to this user clean-up process may be 
accomplished as is shown in the second example entry point (see paragraph 
6.2.1). This type of process may be done, for example, to restore system 
words that are used by the ALLINK program but that are not automatically 
restored by the system. 

e@ The ALLINK processing is incomplete and the program should not be released 
at the time the release command is entered. For example, data saved by the 
ALLINK program has not been completely analyzed. 


The ALLINK program should display a message to the operator and return to the 
system at CALLed address +2. 


Example: 
CLRUP EQU ' 
AOM RELSE can not release yet 
BRU* RELSE 
6.3.2.4 OVERLAY ACTIVE/INACTIVE CALL 


In addition to the command: RELEASE, any overlay can be released automati- 
eally by MASTR in a disk based system when the memory space is needed. 


When this condition oceurs, the system searches overlays and test programs in 
memory and tries to release inactive ones. It is the responsibility of the overlay | 
to indicate if it is active or inactive. To indicating being active, the overlay must 
call ATTA subroutine (SYXVEC + 64) and DTTA ((SYXVEC + 65) when it is no 
longer needed for a station. An active indicator for each station is shown in 
NAME command output. During the automatic release process, the overlay is 
also called at RELEASE entry point. 


Prior to calling the background part of an overlay, the system automatically 
indicates that it is active and clears it to inactive upon background return. 
6.4 SCHEDULING A BACKGROUND TASK FROM FOREGROUND 
Within the ALLINK program, the foreground section may call a routine in the 


background section in order to perform some background-type processing; for 
example, to print a message on data collected by foreground. 


Note that while these sections are part of the same overlay, they perform as 
separate tasks. Foreground initiates this type of call through the scheduler. If 
the foreground and the background tasks share a common data area, the fore- 
ground task has to wait to allow the background task to finish using the data area. 


6.4.1 Flag word 


A flagword must be provided to indicate background or foreground activity. This 
word is a local variable; it is defined and used exclusively within the ALLINK 
program. The flagword is turned on by foreground processing and turned off at 
the end of the background processing so that the next time the foreground task 
comes in, it can tell if the background process is done. Refer to figure 6-1 for a 
typical ALLINK program. 


6.4.2 Foreground Procedure 


At the beginning of the foreground, entry is made from a test program by an 
EXEC statement. 


l. Test the activity flag to see if the background task is completed. If the flag 
is ON, call the scheduler wait routine, FGWAIT (refer to SYXVEC + 44). This 
makes the foreground task wait one complete scheduler cycle in order to give 
the background time to finish. 

2. At the return from FGWAIT, test the flag again. 


3. If the flag is OFF, start the foreground task. 


Example: 
FG EQU = FOREGROUND START ADDRESS 
LDA FLAG BACKGROUND DONE? 
BZ 23 YES, START FG PROCESS 
BSM* FGWAIT NO, THEN WAIT 
BRU saiaar CHECK FLAG AGAIN 


ae Start foreground 
process here 


At the end of foreground processing: 
l. Set the activity flag ON. 


2. Call the task scheduling routine FGBGRT (refer to SY XVEC + 41) with the 
background process address in index register 7. . 


3. Return to test program execution. 


Example: 


*FG PROCESSING . 
LDA 
STA 
LDX 


BSM* 


BRU* 
* 


BGAD1 EQU 


6.4.3 Calling Background 


D1 
FLAG 
X7,BGADI 


FGBGRT 
FGENTR 


SET ACTIVITY FLAG 

GET ADDRESS OF 

TASK AND SET IN THE 
SCHEDULER 

RETURN TO TEST PLAN THROUGH 
THE FOREGROUND ENTRY POINT. 


THIS MUST BE THE BACKGROUND 
PROCESSING START ADDRESS 


When the background is called because foreground scheduled an activity: 


1. Complete the necessary background processing, (I/O data processing, ete. 
I/O usage and restrictions are described in section 3). 


2. At the end of processing, clear the activity flag. 


3. Exit from background through the global transfer VECTOR COMMAND 


(refer to SYXVEC + 38). 
Example: 


BGADI1 EQU 


LDA 
STA 
BRU* 


DO 
FLAG 
COMMND 
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Any processing 


Clear the flag 


Return 


6.9 PROCESSING A COMMAND THROUGH MONITOR FROM 
FOREGROUND 


To foree the monitor to process a command from the apEeD ares buffer the follow- 
ing steps are taken. 


1. At the background entry: 


@ Save the global PIDPMF (GLOVAR + 16) 

It contains the address of PID entry in IOATAB 
e Save the global CMDPMF+1 (GLOVAR + 43) 

It contains the address of the command record buffer of the current PID. 
e Lock out the current PID from reading another command (bit 13 of 

the first word of IOATAB entry must be set to 1) 


2. Just before returning to monitor through background entry point: 


e Clear the command lock out. 

e@e Place a required command in the record buffer using the address saved. 

e Set the global PIDFLG (GLOVAR + 39) to the saved PIMPMF (the 
address of the entry IOATAB). 


FST MASTR ASSEMBLER REL 2.i 00203 SOURCES *EXMe 
ARR 00000177 ARRCWT 00000146 Bee 09000110 
BGFIN 00000264 BGM] 00000257 BGMSS 00000232 
BGSTAR 00000267 BIIFIN 00900033 CLSE 00000314 
COMFLG 09000105 COMMND 00000706 D1 00000106 
D205 00000112 D4 00000107 EXMPLE 09000024 
FFIX 00000731 FGI 09000160 FSGe2 00000205 
FGBGRT 90000711 FGENT 00000147 FGEX 00000201 
FGWAIT 00000714 FP9 00000111 FwORD 00000000 
GLOVAR 00000420 IERMSG 00000676 LWORND v0000315 
MOVEIT 00000301 MSG 0060900030 MSGIN 00900646 
MSGOUT 00000647 MSGS 90000113 OUTHUF 00000957 
OVBGEP 00000022 PARMS 00000145 PARX 00000104 
PODPMF 00000441 PRCHAR 90000026 RECSUF 00000024 
RELSE 00000020 STARS 00000120 STNO 00000042 
SVX6 00000193 SYXVEC 90000640 TABEND C0000144 
TABLE 00000121 TE205 00000230 TOF 00090027 
WRITR 00000307 X1 00000001 Xe 60000002 
X3 00000003 X4 00000004 x5 00900005 
X6 090000006 X7 00000007 $IOCS 00000645 
Figure 6-1 Sample ALLINK Program 
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00000 
00001 
00002 
0000%3 
00004 
00005 
00096 
00020 
00021 
09022 
09023 
099024 
00025 


00000000 
45705560 
54450000 
00000077 
00000000 
00000315 
00000012 
00000090 
41040020 
00000000 
41000267 
00000000 
41000147 
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THIS IS A SAMPLE ALLINK PROGRAM NAMED 'EXMPLE'! 
IT CAN RE LOADED USING THE SYSTEM COMMAND 


// LOAD 'EXMPLE! 
THE FOREGROUND SECTION IS CALLED BY THE FACTOR STATEMENT 
EXEC EXMPLE (PARAMETER); 
THE FUREGROUND SECTION CALLS THE BACKGROUND ROUTINE 
BGMSG WHICH OUTPUTS A MESSAGE BASED ON THE PARAMETERS 
PASSED TO IT BY FUREGROUNL 
THE BACKGROUND SECTION CAN BE CALLED wITH THE COMMAND 
// FXMPELE 


IT OUTPUTS A PROMPTING CHARACTER &, READ INPUT FROM PID 


AND OUTPUTS IT TO POD 


OBJ 7 
REL MAKE IT RUN=TIME RELOCATABLE 
* 
FOO IO IO RIOR TOI IO IOI TOR IORI IOI RI ITOK IKK 
x * 
* OVERLAY HEADER * 
x * 


KEK HKKKKEKK KEKE KK KKK KKK KKK KKKKKKEKKKKEKKKKAKKKKK 
* 


FWORD DATA Q @ 
TEXT ‘EXMPLE'S lye PROGRAM NAME 
DATA 778 3 ALLINK CODE 
DATA 0 4 
DATA LReORD=FWORD 5 PROGRAM SIZE 
BSS 10 6-15 wOT USED 
RELSE PZE 9) 16 RELEASE ENTRY POINT 
BRUx RELSE 17 IMMEDIATE RETURN 
OVBGEP PZe 0 18 BACKGROUND ENTRY POINT 
BRU BGSTART 19 GO TO BACKGROUND START 
EXMPLE PZE 0 20 FOREGROUND ENTRY POINT 
BRU FGENT el GO TO FORESROUND START 


* 
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00026 
00027 
00030 
00031 
00032 


00033 
00057 


00103 
00104 
00105 
00106 
00107 
00110 
00111 
0011e 
00113 
00114 
00115 
00116 
00117 
00120 


O01e1 


00145 
00146 


00000640 
00000645 
00000646 
00000647 
00000676 
00000706 
00000711 
00000714 
00000731 


00000420 
00000441 


00000024 
000000904 
03000000 
63645760 
00000000 
00000001 


00000024 
00000024 


00000001 
00000002 
09000003 
00000004 
00000005 
00000006 
09000007 


00000000 
00000000 
00000000 
00000001 
00000004 
20000000 
21110000 
00000315 
00000000 
eieieliel 
eC222eeee 
23232323 
P424eded 
12i2leie 


00000024 
00000144 
00000000 
00000000 
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PAGE 


* 
* THE FOLLOWING EQU'S LINK TO SYSTEM GLOBALS AND 
* TRANSFER VECTORS 


* 
SYXVEC 
$IOCS 
MSGIN 
MSGOUT 
IERMSG 
COMMND 
FGBGRT 
FGWAIT 
FFIX 

* 
GLOVAR 
PODPMF 
* 


* TO CONTROL 


x 
RECBUF 
PRCHAR 
TOF 
MSG 


STNO 

* 
BUFIN 
OUTBUF 
* 

* 


EQU 

DATA 
DATA 
DATA 


BSS 


BSS 
BSS 


6406 
SYXVEC+5 
SYXVEC+6 
SYXVEC+7 
SYXVEC+30 
SYXVEC+38 
SYXVEC+41 
SYXVEC+44 
SYXVEC+57 


420B 
GLOVAR+17 


LOCATION OF TRANSFER VECTOR 
IOCS SUBROUTINE 

READ FROM PID ROUTINE 

WRITE PON ROUTINE 

TERMINAL ERRORS 

RETURN TO SYSTEM 


LOCATION OF GLOBAL VARTABLES 
ADDRESS OF POD PMF 


WORDS AND BUFFERS 


20 

4B 
0300000056 
*STOP',0 


1 


RECBUF 
RECBUF 


STZE OF IO BUFFER 
PROMPTING CHARACTER § 
TOP OF FORM CODE FOR $IOCS 


* PROGRAM DATA STORAGES AND CONSTANTS 


PARMS 
ARKCNT 
x 


EQU 
EQU 
EQU 
FQU 
EQ) 
EQU 
EQU 


DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 
DATA 


RSS 
F QU 
DATA 
DATA 


200000008 
211100008 
205 

0 

"1111' 
teeee' 


INDEX 
INDEX 
INDEX 
INDEX 
INDEX 
INDEX 
INDEX 


FG/BG 


REGISTER 
REGISTER 
REGISTER 
REGISTER 
REGISTER 
REGISTER 
REGISTER 


BUSY FLAG 
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00147 
00150 
00151 
00152 


0u153 
00154 
00155 
09156 
00157 
00160 
00161 
00162 
00163 
00164 
00165 
00166 
00167 
00170 
00171 
00172 
00173 
00174 
00175 
00176 


00177 
00200 
o0en1 
00202 
00203 
00204 
00205 
00206 
09207 
00210 
00e11 
00212 
00213 
00°14 
00215 
00216 
00217 
00220 


00e21 
00222 


00°23 
00224 


00225. 


00226 
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00000147 
64000105 
42200153 
12040714 
41000147 


56300145 
45700121 
45600144 
07000604 
54000104 
64000145 
42200221 
244900001 
63000110 
43040177 
24440001 
63000111 
43200230 
76000104 
77000145 
14700000 
11400001 
11700001 
43100140 
41000221 


24440001 
11400001 
77000145 
07500009 
25500000 
55000146 
11500001 
24500090 
63000111 
43200230 


14700000 | 


76000104 
11700001 
43600221 
77000146 
64000146 
42200160 
41000205 


00000221 
07600200 
54000103 


64000106 
3409000105 


4570023e 


12040711 


* 


* 


* FOREGROUND SECTION CALLED BY EXEC STATEMENT 


* 


PAGE 


PE ECCECTICCTCCCCCCCCCCCCSSOS SCC SSCS OC CLCSCLCC CC CC SSS Se Se 


* 
* 
* 


KRKKKKKKKEKK KKK KKK KKK KKK KKKKKKKKKIKKKKKKEKKKKKKER 


_* 


FGENT 


FG1 


ARR 


FGe 


EQU 
LDA 


* 
COMFLG 
x+3 
FGWAIT 
FGENT 


X3,PARMS 
X7, TABLE 


X6, TABEND 


PARX 
PARMS 
FGEX 
1°X4 
Bee 
ARR 
1,X4 
FP9 
TE20S 
PARX 
PARMS 
V,X7 
X4,1 
X71 
FG1 
FGEX 


0,X5 
ARRCNT 
XSy1 
0,X5 
FP9 
TE205 
0,X7 
PARX 
X71 
FGEX 
ARRCNT 
ARRCNT 
FG1 
FGe 


* 
X6 
SVX6 


D1 
COMFLG 


X7,RGMSG ADDRESS OF BACKGROUND ROUTINE 
AND SCHEDULE BACKGROUND 


FGbGRT 


BACKGROUND STILL BUSY? 
NO, GQ AHEAD AND SEND NEXT MSG 


YES, WAIT 


DON'T ALLOW 9 


STORE PARAMETER 


TABLE FULL 


DECREMENT COUNTER 
POINTER TO ARRAY 


ARR SIZE 


DONT ALLOW 9 


END OF ARRAY 


SAVE STATION ID 


TURN ON BACKGROUND BUSY FLAG 


Sample ALLINK Program (Continued) — 
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00227 41040024 


00250 64000112 


00231 


00232 
00233 
09234 
00235 
09256 
00237 
00240 
00241 
00242 
00243 
00244 
00245 
00246 
00247 
00250 
00251 
00252 
00253 
00254 
90255 
00256 
00257 


00260 
00261 
00262 
00263 


00264 
00265 
00265 


12040676 


0000023e 
05640441 
45100027 
12040645 
50000235 
45700121 
56700146 
64000104 
42200264 
24700000 
12040731 
42300247 
63000107 
43300251 
64000120 
41000253 
075000900 
64500113 
54000032 
45100030 
05200003 
12040647 
50000257 


77000104 
45740146 
11700091 
41000237 


00000264 
07009604 
54000105 
01040706 
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* 
TE205 


BRU* 


LDA 
RSMx 


PAGE 


EX“PLE 


Neos 
IFRMSG 


RETURN TO TESTING 


KRARKKKKEKKKEKKEKKKKKKKKK KEKE KKKKKKKEKKKKKREKKKKEKKKERK 


* 


* 


* BACKGROUND ROUTINE SCHEDULED BY FOREGROUND * 


* 


* 


KKK KK KKK KKK KKK KEKE KKK KKK KEKE KEKKKKKKKEKKEKKKEKEKEKKEK 


* 
SGMSG 


BGM1 


BGFIN 


EQU 
LDX* 
LDX 


* 


X¥6/,PODPMF SET X6 TO ADDRESS OF POD PMF 


Xi, TOF 
$1IOCS 

* 

X7, TABLE 


X7,ARRCNT 


PARX 
BGFIN 
0,X7 
FFIX 
x+3 

Od 

a+3 
STARS 
+3 

X5 
MSGS,X5 
STNO 
X1,MSG 
Xe, 5 
MSGOUT 
x 


PAR X 


X7, ARRCNT 


X7,1 
BGM1 


* 


COMFLG 
COMMND 


DO TOP OF FORM IF POD IS LP 
IGNORE ERROR 


DONE? 


GET MESSAGE TO PRINT 


START ADDRESS OF QUTPUT 
NO. OF WORDS TO OUTPUT 


IGNORE ERROR 


DECREMENT COUNT 


CLEAR BACKGROUND BUSY FLAG 


RETURN TO SYSTEM 


Sample ALLINK Program (Continued) 
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00267 
00270 
00271 
00272 


00273 
00274 
00275 
00276 
00277 
00390 


00301 
00302 
00303 
00304 
00305 
00306 


00307 
00310 
00311 
0031e 
00313 


00314 


00000267 
45100033 
64000026 
12040646 
50000272 


05400012 
05500090 
05300002 
64000033 
63000120 
43200314 


00000301 
64500033 
54300057 
11500001 
43400307 
1130000 
41900301 


90000307 
45100057 
052000e4 
12040647 
50000312 
41000267 


00000314 
41040022 


00000315 
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PAGE 
* 
RHR KKKKREKKKEK KEK KEKE KKK KKK KKKKK KK KKKKKEEREKEKKKERKKKKKKK 


* * 
* BACKGROUND SECTION CALLED BY AN OPERATOR COMMAND * 
* // EXMPLE : * 
* , * 
* IT READS A RECORD FROM PID AND OUTPUTS IT TO POD x 
* IT EXITS WHEN FOUR ASTERISKS ARE ENTERED * 
* * 
PKI KK KKK KKK KKK KKK KKK KK KKK KKK KKK KEKE KKKEKKKEEK KKK KKK 
nt 
BGSTART EQU- x 

LOX X1,BUFIN ADDRESS CF INPUT 6&UFFER 

LDA PRCHAR PROMPTING CHARACTER §$ 

BSM*x MSGIN READ A RECORD 

NQP * 


* NOW OUTPUT IT TO POD 


LDX X4,10 
LOX X5,0 
LOX X3,2 
LDA BUFIN THE RECORD = uur ? 
CAM STARS 
BE CLSE YES, EXIT NOw 

x 

MOVEIT EQU x 
LDA BUFIN,X5S 
STA OUTBUF,X3 MOVE IT TO OUTPUT BUFFER 
ATX X5,1 WITH SPACING 
RG NRITR 
ATX X3e2 
BRU MOVEIT 

* 

WRITR EQU * 
LDX X1,OQUTBUF ADDRESS OF QOUTPUT BUFFER 
LOX X2re0 NO. OF WORDS TO OUTPUT 
RSMx MSGOUT 
NOP * IGNORE ERROR 
BRU BGSTART 

* 

CLSE EQU x 

RRU*x OVBGEP RETURN TO SYSTEM 

* 

LWORD EQU * 
END 
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00000177 
00000146 
00000110 
00000264 
00000237 
0000023e 
00000267 
00000033 
00000314 
00000105 
00000706 
00000106 
0000011e 
00000107 
00000024 
00000731 
00000160 
00000205 
00000711 
00000147 
00000221 
00000714 
00000111 
00000000 
00000420 
00000676 
00000315 
00000301 
00000030 
00000646 
00000647 
00000113 
00000057 
000000ee 
00000145 
90000104 
00000441 
00000026 
00000024 
00000020 
00000120 
00000032 
00000103 
00000640 
00000144 
.00000121 
00000230 
00000027 
00000307 
00000001 
00000002 
00000003 
00000004 
00000005 
00000006 
00000007 


00000645 


Figure 6-1 


ARR 
ARRCNT 
B22 
BGFIN 
BGM1 
BGMSG 
BGSTAR 
BUFIN 
CLSE 
COMFLG 
COMMND 


MSGS 
OUTBUF 
OVBGEP 
PARMS 
PARX 
PODPMF 
PRCHAR 
RECBUF 
RELSE 
STARS 
STNO 
SVX6 
SYXVEC 
TABEND 


00164 
00204 
00163 
0N241 
00263 
002ee5 
00023 
00267 
00300 
00147 
00266 
00223 
00230 
00245 
00227 
00243 
00175 
00220 
00226 
00025 
00161 
00151 
00166 
09005 
00026 
00231 
00005 
00306 
00254 
00271 
00256 
0025e 
00302 
00314 
00153 
00157 
0023e 
00270 
00033 
00021 
90247 
00253 
002ee 
00026 
00155 
00154 
00167 
00233 
00304 
00233 
00255 
00153 
00162 
00202 
00155 
00154 
00261 
00234 


00215 00216 90237 00261 


00313 
00276 


00224 


00217 
0015e 
00176 


00207 


00311 
00307 


00160 
00170 


00057 


00277 


00026 


00236 
00210 


00254 
00310 
00275 
00165 
00203 
00221 
00172 
00262 


00301 


00265 


00214 


00171 
00212 


00026 


00267 


0030e 
00173 
00205 
010232 
00174 


00201 
00240 


00026 


00307 
00305 
00177 
00206 


00211 


00260 


0002€ 


00200 
00251 


00213 


00026 00026 00026 


00273 


00252 00274 003501 00303 


00225 00236 00237 0024e 


Sample ALLINK Program (Continued) 


6-15 


Overlay Header Format 
File Type Code List 


WORD 0 0 
l The first four characters of overlay name in TRASCII 
2 The last two characters of overlay name in TRASCII 
oad File type code 
4A Release revision number in TRASCII 
5 File length including header (words) 
6 Expansion size (words) at load time 
7 Reserved for system use 
10 Module relocation value store 
11 Module return address store 
12 PZE for module entry point 
13 BRU for module entry point 
14 PZE for reset/kill entry 
15 BRU for reset/kill process 
16 PZE for special purpose entry 
17 BRU for special purpose entry 
20 PZE for release overlay entry 


21 BRU for release overlay entry 

22 PZE for normal background entry 
23 BRU for normal background entry 
24 PZE for foreground entry 

25 BRU for foreground entry 

26 Number of words in release notes 
27 to 33 Release notes (date) 


FILE TYPE CODE LIST 
[ee 
Code File 


0 Undefined 
20B Manual Analysis 


23B Parameter Distribution 
24B Datalogger 


26B DEBUG 


71B Overlay that takes a long time to execute (EDIT), 
expands (COMPILE), or generates memory files (ASM, COPY). 
72B Data files 


73B Object files 

74B STRING files 

T9B Module test programs 
76B Test programs 

T7B General overlay 


A-2 


Instruction Mnemonics 


B.1 


Opeode 


% 


*¥ * &€ He HF KF Ke HH Ke KH Ke HH HH KF KF KF KH 


20000000 
26000000 
36000000 


064034XX 
066134XxX 


06422400 
06401500 
11000000 
07000000 
06423400 
00000000 
02000000 
03040000 
03200000 
03400000 
03600000 
03100000 
33000000 
02100000 
03500000 
02500000 
02300000 
02040000 
03000000 
04000000 
04440000 
02400000 
02600000 
01000000 


Mnemonic 


ABS 
ADD 
AND 
AOM 
ARD 
ARDS 
ASPAC 
ART 


OPCODES SORTED BY ASCENDING ALPHA OPCODES 


Code Description 


ABSOLUTE PROGRAM LOCATOR 
ADD 

LOGICAL AND 

ADD ONE TO MEMORY 
ALTERNATE READ 

ALTERNATE READ STATUS 
ALTERNATE SPACE 

ALTERNATE READ RECORD TAPE 
ADD TO INDEX 

AUGMENT 

ALTERNATE WRITE 

BRANCH AFTER HALT 
BRANCH ON A-REGISTER TEST 
BRANCH BIT COMPARE 
BRANCH IF EQUAL 
BRANCH IF GREATER 

BRANCH IF GREATER OR EQUAL 
BRANCH IF LESS 

BRANCH IF LESS OR EQUAL 
BRANCH IF NEGATIVE 
BRANCH NOT EQUAL 

BRANCH IF NOT EQUAL TO ZERO 
BRANCH IF NEGATIVE OR ZERO 
BRANCH IF ODD 
BRANCH ON INDICATOR 
BRANCH ON STATE 

BRANCH ON OVERFLOW 
BRANCH IF POSITIVE 

BRANCH IF POSITIVE OR ZERO 
BRANCH UNCONDITIONAL 


Cycles 


ee ee ne ee ee Se 


fae eee a eee Se ee ee ree ee ee ee ee 


B.1 


Opcode 


* 


12000000 


02200000 
12000000 
23000000 
07000604 
30000000 


35000000 
35000000 
07034000 
07036000 
07016000 
07030000 
33000000 
32000000 
07014000 


21000000 


060100XX 


07010000 
06051500 


06041500 


07012400 
07004400 
07000600 


07000200 
24000000 
25000000 
07032000 
05000000 


07000400 
07022000 
07000000 
34000000 


10000000 


27000000 


Mnemonic 


BSM 


BSS 
BZ 
CALL 
CAM 
CLA 
DADD 
DATA 
DIV 
DLD 
DSA 
DSL 
DSN 
DSR 
DST 
DSUB 
DTC 
END 
EOR 
EQU 
ETST 
EXC 
FSKIPB 


FSKIPF 


IDA 
IEN 


Code Description 


BRANCH STORAGE RETURN 
ATM 

BLOCK STORAGE SIZE 
BRANCH IF ZERO 
SUBROUTINE CALL 
COMPARE A WITH MEMORY 
CLEAR ACCUMULATOR 
DOUBLE ADD 

DATA DEFINITION 

DIVIDE 

DOUBLE LOAD 

DOUBLE SHIFT AROUND 
DOUBLE SHIFT LEFT 

DOUBLE SHIFT NORMALIZED 
DOUBLE SHIFT RIGHT 
DOUBLE STORE 

DOUBLE SUBTRACT 

DOUBLE TWO'S COMPLEMENT 
PROGRAM TERMINATOR 
EXCLUSIVE OR 
EQUIVALENCE 

ERROR TEST 

EXCHANGE A AND E 

SKIP FILE FORWARD (ADVANCE 
TO TAPE MARK) 

SKIP FILE BACKWARE (ADVANCE 
TO TAPE MARK) 

INTERRUPT DISABLE 
INTERRUPT ENABLE 

LOAD A FROM RELOCATION 
REGISTER 

LOAD A FROM INDEX 

LOAD A-REGISTER 

LOAD E-REGISTER 

LOGICAL DOUBLE SHIFT 
LOAD INDEX | 
PRODUCE ASSEMBLY LISTING 
LOAD RELOCATION REGISTER 
FROM A 

LOGICAL SHIFT A 

LOAD INDEX FROM A 
MULTIPLY 

NO ASSEMBLY LISTING 

NO OPERATION 

PRODUCE OBJECT PROGRAM 
OR (INCLUSIVE) 
ORIGINATION CONTROL 


OPCODES SORTED BY ASCENDING ALPHA OPCODES (Continued) 


Cycles 


bo GC 


NO RO ke 


B.1 OPCODES SORTED BY ASCENDING ALPHA OPCODES (Continued) 


Opeode 


060010XX 
O60110XX 


060130XX 


00000000 
00000000 
064014XX 
066114XX 
06501500 
06601400 
06611700 
06000500 
06011500 
06001500 
07006000 
07012000 
* 17000000 
07024000 
0646 1500 
07026000 
* 37000000 
06420400 
06000000 


07020000 
07004000 
* 14000000 
* 15000000 
07000611 
07000612 
060000 XX 
* 16000000 
* 22000000 
07002000 
06000400 — 
0642 14XxX 
06061500 


Mnemonic 


PAGE 
PCOMP 
POFF 


STE 
STM 1 
STM 2 
STST 
STX 
SUB 
TCA 
TOF 
WRIT 
WRITM 


Code Description 


PAGINATION CONTROL 
PRIORITY COMPLETE 
PRIORITY OFF (INTERRUPT 
DISABLE) 

PRIORITY ON (INTERRUPT 
ENABLE) 

SUBROUTINE ENTRY POINT 
POSITIVE ZERO (ENTRY PT) 
READ 

READ STATUS 

READ (MAGNETIC) TAPE 
READ TELETYPE 

READ EXCESS WORD COUNT 
REWIND TAPE 

SKIP RECORD BACKWARD 
SKIP RECORD FORWARD 
READ SWITCH REGISTER 
RESET STATE 

REPLACE UNDER MASK 
SHIFT A AROUND LEFT 
SKIP AND WRITE 

SHIFT A LEFT 

SUBTRACT ONE FROM MEMORY 
SPACE 

SELECT PERIPHERAL UNIT 
(DETAILED SPU COMMANDS 
ARE LISTED IN APPENDIX D) 
SHIFT A RIGHT 

SET STATE 
STORE-A-REGISTER 
STORE-E-REGISTER 

SET FST-1 MODE 

SET FST-2 MODE 

STATUS TEST 

STORE INDEX 

SUBTRACT 

TWO's COMPLEMENT A 
TOP-OF-FORM 

WRITE 

WRITE TAPE MARK 


* B23=0 for Absolute Memory Reference of Non-REL Program 
=] for Relocatable Memory Reference with REL Program 


B-3 


Cycles 


| ee ee 


pmend 


pad eed eed peed DNDN et oe DO ODD Oe 


B.2 OPCODES SORTED BY ASCENDING OCTAL OPCODES 


Mnemonic 


¥ee He HH He 


Opceode Code Description Cycles 
| ABS | ABSOLUTE PROGRAM LOCATOR 
00000000 BSS BLOCK STORAGE SIZE 
* 90000000 DATA DATA DEFINITION | 
00000000 END PROGRAM TERMINATOR 
EQU EQUIVALENCE 
LIST PRODUCE ASSEMBLY LISTING 
NOLIST NO ASSEMBLY LISTING 
OBJ SPECIFY OBJECT PROGRAM SIZE 
ORG ORIGINATION CONTROL 
PAGE PAGINATION CONTROL 
* 00000000 BAH BRANCH AFTER HALT ] 
00000000 PROC SUBROUTINE ENTRY POINT 
00000000 PZE POSITIVE ZERO (ENTRY PT) 
* 01000000 BRU BRANCH UNCONDITIONAL 1 
* 02000000 BAT BRANCH ON A-REGISTER TEST l 
* 02040000 BO BRANCH IF ODD l 
* 02100000 BN BRANCH IF NEGATIVE l 
* 02200000 BZ BRANCH IF ZERO l 
* 02300000 BNZ BRANCH IF NEGATIVE OR ZERO l 
* 02400000 ~~ BP BRANCH IF POSITIVE ] 
* 02500000 BNEZ BRANCH IF NOT EQUAL TO 
| ZERO l 
* 02600000 BPZ BRANCH IF POSITIVE OR 
ZERO l 
03000000 BOI BRANCH ON INDICATOR ] 
03040000 BBC. BRANCH BIT COMPARE l 
03100000 BL BRANCH IF LESS ] 
03200000 BE BRANCH IF EQUAL ] 
03300000 BLE BRANCH IF LESS OR EQUAL ] 
03400000 BG BRANCH IF GREATER | 
04000000 BOS BRANCH ON STATE ] 
04440000 BOV BRANCH ON OVERFLOW l 
06000000 SPU SELECT PERIPHERAL UNIT 
(DETAILED SPU COMMANDS 
? ARE LISTED IN APPENDIX D) 
060000XX  STST. STATUS TEST ] 
06000400 TOF TOP-OF-FORM l 
06000500 REWIND REWIND TAPE ] 


B-4 


B.2 


Opeode 


060010 XX 
06001500 
060100XX 
060110XX 


06011500 
060130XX 


06020400 


06041500 


06051500 


06061500 
064014XX 
06401500 


064034XX 
06420400 
064214XxX 
06422400 
06423400 
0646 1500 
06501500 
06601400 
O66114XxX 
06613400 
07000000 
07000000 
07000200 
07000400 


07000600 


07000604 
07000611 
07000612 
07002000 
07004000 
07004400 
07006000 
07010000 


Mnemonic 
PCOMP 
RSKIPF 
ETST 
POFF 


RSKIPB 
PON 


FEED 


FSKIPF 


FSKIPB 


Code Description 


PRIORITY COMPLETE 

SKIP RECORD FORWARD 
ERROR TEST 

PRIORITY OFF 
(INTERRUPT DISABLE) 
SKIP RECORD BACKWARD 
PRIORITY ON (INTERRUPT 
ENABLE) 

CHARACTER (PAPER TAPE) 
FEED 

SKIP FILE FORWARD 
(ADVANCE TO 

TAPE MARK 

SKIP FILE BACKWARD 

(GO BACK TO TAPE MARK) 
WRITE TAPE MARK 

READ 

ALTERNATE READ RECORD 
TAPE 

ALTERNATE READ 

SPACE 

WRITE 

ALTERNATE SPACE 
ALTERNATE WRITE 

SKIP AND WRITE 

READ (MAGNETIC) TAPE 
READ TELETYPE 

READ STATUS 
ALTERNATE READ STATUS 
AUGMENT 

LOAD INDEX FROM A 
LOAD A FROM INDEX 


LOAD RELOCATION REGISTER 


FROM A 

LOAD A FROM RELOCATION 
REGISTER 

CLEAR ACCUMULATOR 
SET FST-1 MODE 

SET FST-2 MODE 

TWO'S COMPLEMENT A 
SET STATE 

INTERRUPT ENABLE 
READ SWITCH REGISTER 
EXCHANGE A AND E 


OPCODES SORTED BY ASCENDING OCTAL OPCODES (Continued) 


Cycles 


a ee ee ee ee oe ee ee | 


— a) 


— 


ee ee 


B.2 


Opceode 


x & & 


*¥ ££ &*¥ &¥ & HH He He KF HEHEHE He HF He HEH KH KH 


07012000 
07012400 
07014000 
07020000 
07022000 
07024000 
07026000 
07030000 
07032000 
07034000 
07036000 
10000000 
11000000 
12000000 
12000000 
14000000 
15000000 
16000000 
17000000 
20000000 
21000000 
22000000 
23000000 
24000000 
25000000 
26000000 
27000000 
30000000 
31000000 
32000000 
33000000 
34000000 
39000000 
36000000 
37000000 


OPCODES SORTED BY ASCENDING OCTAL OPCODES (Continued) 


Mnemonic 


Code Description 


RESET STATE 

INTERRUPT DISABLE 
DOUBLE SHIFT NORMALIZED 
SHIFT A RIGHT 

LOGICAL SHIFT A 

SHIFT A AROUND LEFT 
SHIFT A LEFT 

DOUBLE SHIFT RIGHT 
LOGICAL DOUBLE SHIFT 
DOUBLE SHIFT AROUND 
DOUBLE SHIFT LEFT 

NO OPERATION 
ADD TO INDEX 

BRANCH STORE RETURN ATM 
SUBROUTINE CALL 

STORE A-REGISTER 

STORE E-REGISTER 

STORE INDEX 

REPLACE UNDER MASK 
ADD 

EXCLUSIVE OR 

SUBTRACT 

COMPARE A WITH MEMORY 
LOAD A-REGISTER 

LOAD E-REGISTER 
LOGICAL AND 

OR (INCLUSIVE) 

DOUBLE ADD 

DOUBLE LOAD 

DOUBLE SUBTRACT 
DOUBLE STORE 

MULTIPLY 

DIVIDE 

ADD ONE TO MEMORY 
SUBTRACT ONE FROM MEMORY 


Bit 23 = 0 for Absolute Reference of non-REL Program 
= 1 for Relocation Memory Reference with REL Directive 


B-6 


Cycles 


] 
] 


NO NO re 


bo DO 
Hm m O 1 dG GW dw WD DID DD DH WDD D D Do 


Cc 


Conversion of TOPSY/DOPSY 
Assembly Language Programs 
to MASTR 


C.1 INTRODUCTION 


To run in MASTR, assembly language overlays must be modified to include a pro- 
gram header, to use the new global variables, and to follow the calling sequences 
as defined for IOCS and system subroutines. 


The same overlay may be called from the FACTOR program by the EXEC state- 
ment and from a command from the background. There is no need to maintain 
two copies of the program as in TOPSY. 


MASTR ean load and execute an assembly language overlay at any location in 
memory. It is no longer necessary to create the coreimage files at specific loca- 
tions to avoid overlap with other coreimage files. 


Note 
The object files are no longer supplied on the system 
DBUP tape. 
C.2 PROCEDURE 


This section defines a step by step procedure for the conversion of DOPSY/ 
TOPSY assembly language programs to MASTR. The difficulty of the conversion 
depends to a great deal on the complexity of the program and the familiarity of 
the programmer doing the conversion with that program. If the program is well 
structured and documented, the conversion should be straight forward. 


l. In the job 'HELP’, there is a source file named '*AHDR'. Add this header 
to the program by inserting the existing program in the appropriate place 
for a foreground or background program. Note that a foreground entry is 
made when called from a FACTOR program by means of the EXEC state- 
ment. The background entry is made when called by a command. 


Examine all EQU statements to find references to system globals. If any 


exist, then their usage must be examined and replaced with the equivalent 
in MASTR. Note that there is not always a direct replacement for a 
DOPSY/ TOPSY variable. System globals in MASTR will be located in 
SYSVAR (system variables), GLOVAR (global variables), TVT (test head 
variables), and SVT (current station variables). 


Examines all EQU statements to fine uses of system routines that are 

ealled by a BSM#* instruction. These calls must be replaced with the equiva- 
lent call to MASTR by the SYXVEC table. Note that some calling se- 
quences are different, i.e., the floating point routines use the E-register 
instead of a parameter placed after the call. 


~ Examine all CALL statements to find references to external routines. 


a. The routine that is called may now be a part of the MASTR rou- 


tine library, so examine the routines in SYXVEC for an equivalent 
function. | 


b. The routine that is called may be another part of the program 
_ that also must be converted. A linking CREATE program is available 
on MASTR Rel 2.0. When linking object files together to make a 
MASTR overlay, put the tag LASTW on the END instruction of the last 
module only and link it to the first module with an ENT and EXT in- 
_ struction. Also change the fifth word to be "DATA LASTW". | 


Examine the program for any PROC directives with an interrupt location 
specified. Also examine the program for any SPU instruction to I/O 
devices. All routines that perform direct input/output to a peripheral must 
be changed to use IOCS. An overlay may read and write directly to the test 
registers providing the usage does not conflict with the test head driver. 


Add an initialization section that: 
a. clears any flags that must be 0 upon entry - remember that the 
programs may not be reloaded from the disk each time. The routine 


MPZERO may be useful for this function. 


b. opens files for I/O and saves the pointers to IOATAB (X6), for 
use by subsequent calls to IOCS. 


Define data control blocks (DCBs) in MASTR format for each I/O operation 
and change all calls to use IOCS. 


10. 


Upon exit from the program, all files that are open must be closed (even 
upon exit due to an error). This is required so that the system IOATAB is 
not filled with files that are no longer used. The IOATAB pointer serves as 
a useful flag if coded as follows: 


EXIT - 
LDA IOATP Get File ID 
BZ CLOSED File Already Closed 
LXA X6 Set Up ID for IOCS 
CLA 
STA IOATP Mark File Closed 
LDX #£=X1,CLOSE Get Control Word 
BSM * IOCS Close the File 
BRU ERROR Error Return 
CLOSED ~ 


Change program exit to return through the foreground (FGEP) or background 
(BGEP) as appropriate. 


Check for conflicting uses of index registers and state switehes with the 
new system routines, i.e., IOCS uses X1 and X6. | 


C-3 


Index 


ACTFIO, 2-12, 2-20 
ADJFLG, 2-11, 2-17 
ADJMEM, 3-2, 3-9, 3-10 
ADRXLA, 3-3, 3-63, 3-64 
AFGBGF, 2-12, 2-24 
ALLEX, 3-2, 3-40, 3-41 
ALLINK, 1-3, 6-1 to 6-15 
Calling procedure, 6-4 to 6-6, 6-8 
Creating coreimage, 6-3 
Foreground/background processing, 
6-1, 6-9 
Header, 6-2 
Loading procedure, 6-3 
Program definition, 6-2 
Risks, 6-1, 6-2 
Sample program, 6-9 to 6-15 
Seheduling, 6-6 to 6-8 
ALTER, 3-2, 3-26, 3-27 
APMREV, 2-11, 2-13 
Assembly language overlays, see ALLINK 
ATHDF, 2-12, 2-22 
ATPA, 2-11, 2-13 
ATTA, 3-3, 3-55, 3-56 
AWATE, 2-12, 2-22 


BFLERR, 2-12, 2-21 
BGCHK, 3-3, 3-70 
BGID, 2-12, 2-25 
BINARY, 2-12, 2-21 
BINC, 2-11, 2-20 
BINCNT, 2-12, 2-22 
BINUM, 2-11, 2-20 


CALLMOD, 3-3, 3-71 

CATGRY, 2-12, 2-25 

Clear VKT, 4-18, 4-19 

-CLI/CLO blocked file, 5-11 
CLI/CLO unblocked file, 5-11 
CLI/CLO variable length file, 5-12 


CLIO disconnect, 4-29 
CLIOID, 2-12, 2-24 
Close a file, 4-27 
CMDPMF, 2-11, 2-18 
CMDV, 2-11, 2-19 
COLFLG, 2-12, 2-20 
COMERR, 3-2, 3-6 
COMIMG, 2-11, 2-18 
COMMND, 3-2, 3-41 
CONV, 3-2, 3-13 
Coreimage files, 5-34, 5-35, 5-36 


Current station variables, 2-43 to 2-52 


CURSYS, 2-11, 2-16 


Data files, fixed length, 5-33, 5-34 
Data files, variable length, 5-18 to 5-20 


DATA/INSTRUCTION, 5-38 

Datalog record format, 5-22 

DATE, 2-11, 2-16 

DBUGSA, 2-12, 2-23 

DELFIL, 3-3, 3-55 

Device, close a file, 4-28 

DEVNUM, 2-12, 2-24 

DFDV, 2-8 — 

DFSTAT, 2-12, 2-23 

Direct current fail reeord, 5-24 

Direct current pass reeord, 5-25 

Disk files and usage, 5-1 to 5-4 
Disk directory entry, 5-3 
Disk file format, 5-4 
Disk organization, 5-1, 5-2 
Disk specification, 5-1 

DMASTR, 3-3, 3-59, 3-60 

DPS trip fail record, 5-23 

DRPMF, 2-11, 2-15 

DTTA, 3-3, 3-56 


DUMP, 3-2, 3-36, 3-37 


ECHFLG, 2-11, 2-18 


Index-1 


ENBTST, 3-3, 3-62, 3-63 
END, 5-40 

End of test record, 5-31 
ENT, 5-40 

ENTBSY, 3-3, 3-65 
ERRCNV, 3-2, 3-45 
EXT, 5-39 


FACTOR, writing from, 5-32 
FADD, 3-2, 3-48 
Fail message, functional, 5-28, 5-29 
Fail record, direct current, 5-24 
Fail reeord, DSP trip, 5-23 
Fail record, functional, 5-26, 5-27 
FAND, 3-2, 3-46 
FCAM, 3-3, 3-53 
FDIV, 3-2, 3-48 
FEOR, 3-2, 3-47 
FEXP, 3-3, 3-50 
FFIX, 3-3, 3-51 
FFIXS, 3-2, 3-49 
FFLT, 3-3, 3-52 
FFLTS, 3-3, 3-52, 3-53 
FGBGFL, 2-11, 2-16 
FGBGH, 3-3, 3-57 
FGBGRT, 3-2, 3-43 
FGBGWT, 3-3, 3-57 
FGIO, 3-3, 3-58, 3-59 
FGOH, 3-3, 3-60, 3-61 
FGOVC, 3-2, 3-40 
FGWAIT, 3-2, 3-44 
File(s) 
Coreimage, 5-34, 5-35, 5-36 
Data, 59-18 to 5-34 
End input, 4-31, 4-32 
End output, 4-32, 4-33, 4-34 
Object, 5-37 to 5-40 
Request, 4-35 
Stored in memory, 5-12 to 5-17 
String, 5-18 
System, 1-3 
Transferred to Integrator, 5-10 to 
9-12 
Transmit (add), 4-29, 4-30 
Transmit (create), 4-30, 4-31 
Type 010, 5-37 
Type code list, 5-36 
FINDVL, 3-3, 3-58 
Fixed length data files, 5-33, 5-34 
FLOG, 3-2, 3-47 
FMUL, 3-3, 3-51 
FNOT, 3-3, 3-50 
FOR, 3-2, 3-49 


FSUB, 3-2, 3-46 


Functional failure message, 5-28, 5-29 
Functional failure record, 5-26, 5-27 
Functional failure record, PPM, 5-30 
FWALT, 2-11, 2-15 

FWAM, 2-11, 2-17 

FWIOA, 2-11, 2-15 

FWMAC, 2-11, 2-15 


General record format, 5-19 
GETC, 3-2, 3-33 

Global constant, 2-1, 2-4 to 2-7 
Global data, 1-2 

Global subroutine, 2-2 

Global variable, 2-2 

GLOVAR, global variable, 2-11 to 2-25 
GTSTAT, 3-2, 3-12 
GTTDV, 3-2, 3-38, 3-39 


HEADER, 3-2, 3-39 
Header record format, 5-21 


IDTSCN, 3-2, 3-29, 3-30 

IERMSG, 3-2, 3-36 

Input/output control system ($IOCS), 
1-3 
ASCII eontrol mode, 4-40 
Calling sequence, 4-5 
CLIO diseonnect, 4-29 
Close a file, 4-27 
Device formats, 4-7, 4-8 
Devices, 4-3 
Driving I/O device, 4-7 
End of file definition, 4-4 
End of reeord definition, 4-5 
EOF mark, 4-23 
Error code, 4-4 
File end input, 4-31, 4-32 
File end output, 4-32, 4-33, 4-34 
File request, 4-35 
File transmit (add), 4-29 
File transmit (create), 4-30 
Functions, 4-3 
Initialization, 4-6 
IOATAB, 4-9 
OPEN call, 4-12 to 4-15 
Operation principles, 4-1, 4-2 
Operator message, 4-28 
Page a block into memory, 4-38 
READ/WRITE record, 4-16 to 4-18 
Rewind magnetic tape, 4-39 
Skip a file, 4-22 
Skip a record, 4-37 


Index-2 


Status check request, 4-24, 4-25 MASTR file deseription, 5-1 to 5-40 


Terminate I/O, 4-18, 4-19 MEMBSY, 2-12, 2-20 
Termination, 4-7 Memory activity table, 5-14, 5-15 
Top of form, 4-20 Memory map, 5-16, 5-17 
Unformatted write, 4-21 MONINT, 3-2, 3-43, 3-44 
VERIFY/READ, 4-26 MOVEDN, 3-2, 3-16 
VKT transmit, 4-36 MOVEUP, 3-2, 3-17 
Word formats, 4-10, 4-11 MPZERO, 3-2, 3-33 
Integrator : MSGIN, 3-2, 3-7 
Disconnect CLIO, 4-29 MSGOUT, 3-2, 3-7, 3-8 
File end input, 4-31 
File end output, 4-32, 4-33, 4-34 NAME1, NAMEQ, 2-12, 2-22 
File request, 4-35 NAMEM1 through NAMEMB6, 2-11, 2-12, 
File transmit (add), 4-29, 4-30 2-20 
File transmit (create), 4-30, 4-31 NIOA, 2-11, 2-16 
Files transferred to, 5-10, 5-11, 5-12 NMAC, 2-11, 2-14 
Operator message, 4-28 NSVT, 2-11, 2-14 
INTSCN, 3-2, 3-31 NTVT, 2-11, 2-13 
INUMB1, INUMB2, 2-12, 2-21 NUMBI1, NUMB2, 2-12, 2-21 
INTERP, 3-3, 3-76 NUMBER, 3-2, 3-30, 3-31 
I/O assignment table (IOATAB), 4-9 NUMERR, 3-2, 3-5 


NUMFLG, 2-12, 2-22 
JOB, 2-11, 2-16 
Object files, 5-37 to 5-40 


LDFLG, 2-11, 2-19 DATA/INSTRUCTION, 5-38 
LOAD, 3-3, 3-63, 3-64 File type 010, 5-37 
LOTNUM, 2-12, 2-24 END, 5-40 
LWALT, 2-11, 2-15 ENT, 5-40 
LWAM, 2-11, 2-17 EXT, 5-39 
LWCPU, 2-11, 2-17 PROC/CALL, 5-39 
LWMAC, 2-11, 2-15 START, 5-38 
LWSYS, 2-11, 2-17 ~  OCTAL, 2-11, 2-18 
OFLERR, 2-11, 2-19 

M1FDA, 2-8, 2-10 ONUMB1, ONUMB2, 2-12, 2-20 
MIFDDA, 2-8, 2-10 OPEN eall to $IOCS, 4-12 to 4-15 
MIINIT, 2-8, 2-9 Operator message, 4-28 
M1WSDA, 2-8, 2-9 OPHL, 2-11, 2-16 
MI1WSSC, 2-8, 2-9 OUTCLS, 3-2, 3-5 
M1WSWC, 2-8, 2-9 OUTOPN, 3-2, 3-4 
MACTAB, 5-14, 5-15 Overlay header format, 5-35 
Magnetie tape 

Rewind, 4-39 PAGTP, 3-3, 3-57 

Skip file mark, 4-22 $PARSE, 3-2, 3-28, 3-29 

Skip reeord, 4-37 Pass record, direct current, 5-25 

Write EOF mark, 4-23 PIDFLG, 2-11, 2-18 
Magnetic tape files and usage, 5-4 to PIDPMFP, 2-11, 2-15 

o-9 PGPMF, 2-11, 2-17 

Bloeked file format, 5-4, 5-5 PODPMF, 2-11, 2-15 

MBUP format, 5-8 PPM functional failure record, 5-30 

Organization, 5-4 PROC/CALL, 5-39 

TDX-generated, 5-6 to 5-8 PROCESS, 3-2, 3-19 to 3-25 
MANTISSA, 2-11, 2-19 PUTA, 3-3, 3-70 
MASTAT, 2-12, 2-24 PUTB, 3-3, 3-72 
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PUTC, 3-2, 3-15 SMF, 2-43, 2-45 


PUTD, 3-2, 3-14 SMR, 2-43, 2-49 
PUTE, 3-2, 3-18 SMSR, 2-43, 2-45 
PUTENG, 3-3, 3-68, 3-69 SMSRH, 2-43, 2-47 
PUTH, 3-3, 3-73 SPDA, 2-12, 2-24 
PUTIME, 3-2, 3-37 SPG, 2-43, 2-48 
PUTO, 3-2, 3-18 SPIN, 2-43, 2-45 
PUTW, 3-2, 3-42 SPIOER, 3-2, 3-39, 3-40 

SPMOD, 2-43, 2-48 
RAIDBK, 2-12, 2-24 | SPNUM]1 to SPNUMB6, 2-12, 2-21 
RAIDER, 2-12, 2-24 SPOPT, 2-12, 2-22 
RAIDRR, 2-12, 2-22 SQ, 2-43, 2-49 
RELOV, 3-3, 3-55 SQL, 2-43, 2-49 
READ/WRITE record, 4-16, 4-17, 4-18 SSAMC, 2-43, 2-49 
READW, 3-2, 3-34 STALL, 3-3, 3-66 
Reeord format, datalog, 5-22 START (object files), 5-38 
Record format, general, 5-19 STATC, 2-12, 2-21 
Record format, header, 5-21 Status check request, 4-24 
RELDAT, 2-11, 2-13 Status word description, 4-25 
REVN, 2-11, 2-16 STAVKT, 2-11, 2-15 
RSOVC, 3-3, 3-65, 3-66 | STEF, 2-43, 2-46 _ 
RSTIO, 2-12, 2-20 STHC, 2-43, 2-44 
RSTTSC, 2-12, 2-25 STPP, 2-43, 2-47 

String files, 5-18 
S488CT, 2-43, 2-51 STRIP, 2-43, 2-47 
SAPMCT, 2-43, 2-52 STX, 5-10 
SAVENV, 3-3, 3-73 Subroutines, system, 1-2, 3-1 to 3-73 
SCALE, 3-2, 3-44 SVHI, 2-43, 2-51 
SCNFIL, 3-2, 3-10, 3-11, 3-12 SVHIE, 2-43, 2-51 
SDCT0, 2-43, 2-50 SVLO, 2-43, 2-51 
SDCTOE, 2-43, 2-50 SVLOE, 2-43, 2-51 
SDCTI, 2-43, 2-50 SVOFFS, 2-43, 2-46 
SDCTIE, 2-43, 2-50 SVT (current station variables), 2-43 to 
SDLAF, 2-43, 2-48 2-52 | 
SEARCH, 3-2, 3-32 SYSINT, 2-8, 2-10 
SEIR, 2-43, 2-45, 2-46 SYSREL, 2-12, 2-24 
SELP, 2-8, 2-9 System memory map, 5-16, 5-17 
SFR, 2-43, 2-49 | System variable, 2-2, 2-8 
SFVAL, 2-43, 2-47 SYSVAR, 2-8 to 2-10 
SIFC, 2-43, 2-48 | SYXVEC, 3-1 to 3-3 
SIFV, 2-43, 2-48 | 
SIHI, 2-43, 2-51 | Table 
SITHIE, 2-43, 2-51 Current station variables (SVT), 2-43 
SILO, 2-43, 2-50 Global constants, 2-4 to 2-7 
SILOE, 2-43, 2-50 _ Global variables, (GLOVAR), 2-11, 
SINC, 2-43, 2-47 2-12 

SITE, 2-43, 2-44 Subroutine transfer vector (SY XVEC), 

SITEQQ, 2-11, 2-13 3-2, 3-3 
Skip file mark, 4-22 System global variables (SYSVAR), 
SLIMO, 2-43, 2-49 2-8 
SLIM], 2-43, 2-50 Tester variables (TVT), 2-26 to 2-28 
SLML, 2-43, 2-46 ‘ TAPMF1, TAPMF2, 2-27, 2-36 
SMAFLG, 2-12, 2-23 | TAPMP1, TAPMP2, 2-27, 2-36 
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TATTA, 2-28, 2-41 TRTDS, 2-28, 2-41 


TBINS, 2-27, 2-37 TSN, 2-26, 2-28 

TBINT, 2-27, 2-37 TSTEP, 2-27, 2-37 

TCLO, 2-28, 2-38, 2-39 TSWITCH, 2-26, 2-28 

TCPC, 2-27, 2-30 TSYNC, 2-27, 2-35 

TCR, 2-27, 2-38, 2-39 TTITLE, 2-28, 2-42 

TDATAL, 2-26, 2-29 TTT, 2-26, 2-28 

TDCDLY, 2-27, 2-30 TTTK, 2-27, 2-38, 2-39 

TDFR, 2-27, 2-34 TTTP, 2-28, 2-38, 2-39 

TDIF, 2-28, 2-38, 2-39 TVALUE, 2-26, 2-28 

TDLC, 2-27, 2-33 TVK2, 2-28, 2-38, 2-39 

TDLF, 2-27, 2-32 TVP2, 2-28, 2-38, 2-39 

TDLO, 2-27, 2-32 TVT, 2-11, 2-14 

TDLS, 2-27, 2-32 TVTLG, 2-27, 2-38 

TDOF, 2-28, 2-38, 2-39 TVTLL, 2-27, 2-36 

TDLR, 2-27, 2-32, 2-33 TWAIT, 3-2, 3-42 

Terminate I/O, 4-18, 4-19 

Tester variables, 2-26 to 2-28 UMSGW, 3-2, 3-8 

TGLOB1 through TGLO40, 2-26, 2-29 UPDATE, 3-3, 3-66, 3-67, 3-68 
THDACT, 2-11, 2-17, 2-18 USVENV, 3-3, 3-73 

TIME, 2-11, 2-16 

TINDEX, 2-27, 2-29 Variable length record data files, 5-18 
TIP, 2-27, 2-37 to 5-20 

TJOB, 2-28, 2-41 File format, 5-20 

TLP, 2-28, 2-38, 2-39 Record format, 5-19 
TLMFC, 2-27, 2-33 VERIFY/READ, 4-26 
TMACTL, 2-27, 2-34, 2-35 VET transmit, 4-36, 4-37 
TMADSP, 2-35 

TMIF, 2-28, 2-38, 2-39 WAIT, 3-2, 3-4 

TMOD, 2-27, 2-36 Write (unformatted), 4-21 
TMOF, 2-28, 2-38, 2-39 WRITEW, 3-2, 3-35 

TMPIN, 2-27, 2-38 Writing from FACTOR, 5-32 
TMSTK, 2-28, 2-41 Word formats (IOATAB), 4-10, 4-11 
TMTRI1, 2-27, 2-38, 2-39 WWAIT, 3-3, 3-62, 3-63 
TMTR2, 2-27, 2-38, 2-39 

TMTW1, 2-28, 2-38, 2-39 $IOCS, see input/output control system 
TMTW2, 2-28, 2-38, 2-39 $PARSE, 3-2, 3-28, 3-29 


TODLY, 2-27, 2-31 
TOMSTK, 2-28, 2-41 
Top of form, 4-21 
TOPT, 2-28, 2-40 
TOVER, 2-27, 2-31 
TPAUSE, 2-27, 2-37 
TPDD, 2-27, 2-36 
TPDF, 2-27, 2-34 
TPDR, 2-27, 2-34 
TPDS, 2-27, 2-34 
TPHL, 2-11, 2-16 
TPID, 2-27, 2-38, 2-39 
TPOD, 2-28, 2-38, 2-39 
-TPPO, 2-27, 2-35 
Transfer vector, subroutine, 3-1 
TRTD, 2-26, 2-29 
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